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; this page is auto-generated on each build from the pinned submodule’s source.

Note

These pages are regenerated by a Sphinx extension on every build. Edits made directly to files under stl/_generated/ 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.