printStackTrace (--)

Inputs

• None.

Outputs

• None.

printStackTrace does not change the data stack. It only prints the current scope stack.

The printed format includes the file path directly. Each printed frame also includes the node text, line, and column.

Behavior

• The first printed frame is the current location.
• Older frames follow on later lines with the suffix , Called from here.
• Each line includes the file path, line, column, and the formatted source text of the node for that frame.
• The printed order is newest frame first and oldest frame last.
• The builtin does not consume data-stack values.
• The builtin does not push new data-stack values.

Example

test.mpl

{} 0 {} [
  inner: [printStackTrace];
  outer: [inner];
  outer
  0
] "main" exportFunction

Expected Output During Compilation

test.mpl(2,11): «printStackTrace»
test.mpl(3,11): «inner», Called from here
test.mpl(4,3): «outer», Called from here
test.mpl(6,10): «exportFunction», Called from here

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.
• printStack builtin (--) Prints the current data stack in canonical formatter form; it does not itself pop stack values.
• raiseStaticError builtin (message --) Raises a compile-time error with the given known Text message.