printStack (--)

Inputs

• None.

Outputs

• None.

printStack prints the current data stack without modifying it.

Behavior

• The current data stack is printed from bottom to top.
• Each stack item is formatted in the formatter's canonical representation and printed on its own line.
• The builtin does not consume stack values.
• The builtin does not push new stack values.

Example

{} 0 {} [
  "-- original stack --" printCompilerMessage
  7 "hi" FALSE
  printStack

  "-- printStack does not pop --" printCompilerMessage
  printStack

  "-- after one manual pop --" printCompilerMessage
  _:;
  printStack
  _:; _:;
  0
] "main" exportFunction

Expected Output During Compilation

-- original stack --
7
"hi"
FALSE
-- printStack does not pop --
7
"hi"
FALSE
-- after one manual pop --
7
"hi"

See also

• failCompilation builtin (--) Aborts compilation immediately.
• getCallTrace builtin (-- callTrace) Returns a Ref to the current call trace, or NIL when unavailable.
• printCompilerMessage builtin (message --) Prints a known Text message during compilation and appends one line-feed character.
• printStackTrace builtin (--) Prints the current scope stack as file path, line, column, and node source text information.
• raiseStaticError builtin (message --) Raises a compile-time error with the given known Text message.