raiseStaticError (message --)

Inputs

• message: Known Text used as the error message.

Outputs

• None.

This builtin takes one known Text input and has no outputs. After the message is validated, compilation fails unconditionally.

The reported error text is the supplied message.

Behavior

• The message must be a known Text value.
• The builtin has no outputs because it always raises an error.
• The language-level error text is the supplied message.
• It accepts caller-supplied error message text.

Example

test.mpl

{} 0 {} [
  "custom message" raiseStaticError
  0
] "main" exportFunction

Expected Compilation Error

test.mpl(2,20): «raiseStaticError», custom message
test.mpl(4,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.
• printStackTrace builtin (--) Prints the current scope stack as file path, line, column, and node source text information.