hex.pointers.stack_init

Initializes a stack of size n (maximal capacity of n hexes / return-addresses).
n is the size of the stack.

Signature

def stack_init n @ stack_error_handler > sp, stack { ... }

Defined in hex/pointers/basic_pointers.fj — lines 86–98 (view on GitHub).

Complexity

  • Time: O(1)

  • Space: n+w/4 + 330

See the complexity glossary for what @, w, dw, dbit, n mean.

Output labels

This macro exposes labels into the caller’s scope via >:

  • sp — the stack pointer. sp always points to the last pushed value (at start - to stack[-1])

  • stack — the global stack.

Source

Click to view the macro body

def stack_init n @ stack_error_handler > sp, stack {
  sp:
    hex.vec w/4, .stack

    pad w
  stack:
    hex.hex stack_error_handler
    hex.vec n, 0

  stack_error_handler:
    stl.output "\n\nERROR: You returned on an empty stack.\n"
    ;0      // (would fail, so the stack trace would be printed).
}

Depends on

Used by

Example uses

← Previous: hex.pointers.set_flip_and_jump_pointers Next: hex.ptr_jump →