DEBUG (-- debugCondition)

Inputs

• None.

Outputs

• debugCondition: Known Cond reporting debug-mode status.

This builtin has no inputs. It pushes a known Cond value that reflects the program's debug-mode setting.

DEBUG is a value builtin. It does not affect later declarations or scope state.

Because the actual setting may be either enabled or disabled, the example below does not hardcode one particular value. It instead shows two stable facts: DEBUG is known at compile time, and it is always either FALSE or TRUE.

Behavior

• The result is known at compile time.
• The result schema is Cond.
• The exact value depends on the active debug-mode setting.
• Because the result is known, it drives compile-time condition handling.

Example

{} 0 {} [
  "-- DEBUG is a known Cond --" printCompilerMessage
  DEBUG known? printStack _:;

  "-- DEBUG is either TRUE or FALSE --" printCompilerMessage
  DEBUG FALSE = DEBUG TRUE = or printStack _:;

  0
] "main" exportFunction

Expected Output During Compilation

-- DEBUG is a known Cond --
TRUE
-- DEBUG is either TRUE or FALSE --
TRUE

See also

• FALSE builtin (-- falseCondition) Pushes the false condition value.
• TRUE builtin (-- trueCondition) Pushes the true condition value.
• if builtin (condition trueCallable falseCallable -- branchResult) Calls one of two Blocks; unknown conditions require both branches to be compiled and merged.
• uif builtin (condition trueCallable falseCallable -- branchResult) Processes one of two Blocks inline, depending on a known Cond value.