Standard Library

The FlipJump standard library (STL) builds variables, arithmetic, I/O, pointers, and a stack on top of FlipJump’s single instruction. Every macro on the per-file pages below comes from the upstream flipjump/stl/ directory; the per-file and per-macro pages here are auto-generated on each build from the pinned submodule’s source.

Note

The per-file pages (e.g. /stl/bit/math.html) and per-macro pages (e.g. /stl/bit/math/add--3.html) are regenerated by a Sphinx extension on every build. Edits made directly to those files are overwritten — to change what a macro page says, edit the upstream .fj source instead.

Module layout

The STL is organised as three top-level namespaces:

• stl — runtime startup, I/O, control flow primitives. Most programs need stl.startup first and stl.loop last.

• bit — bit-level variables, logic, arithmetic, I/O, pointers. Useful for fine-grained control over individual bits.

• hex — hex (4-bit) variables, generally faster and more compact than bit-level equivalents. Includes pointer + stack support via hex.pointers.*.

File reference

Each file below corresponds to one .fj source file under flipjump/stl/. The order matches conf.json — the canonical compilation order — so dependencies appear before their consumers.

• runlib.fj
  • Constants
  • Macros
• casting.fj
  • Macros
• ptrlib.fj
  • Macros
• bit — namespace overview
  • Contents
• hex — namespace overview
  • Contents

All macros at a glance

The all-macros index lists every macro across every namespace in one searchable table, sorted alphabetically by fully-qualified name. Useful when you know roughly what you want but not which file it lives in.