getCallTrace (-- callTrace)

Builtins

Name introduction, declaration modifiers, and module binding: NAME: ...;, codeRef, def, exportFunction, importFunction, importVariable, overload, private, static, use, and virtual.
Struct construction forms: (...), {...}, and array.
Selection forms: source-text selection with NAME and .NAME, read-only source-text selection with @NAME and .@NAME, and ordinal or known-name data-input selection with @, callField, and fieldRead.
Writing forms: source-text selection with !NAME and .!NAME, ordinal selection with ! and fieldWrite, and already-selected destination replacement with set.
Calling and control flow: call, if, loop, ucall, and uif.
Text operations: &, LF, attribute, textSize, and textSplit.
Condition constants, value comparison, and logical operators: <, =, >, DEBUG, FALSE, TRUE, and, is, lshift, or, rshift, xor, and ~.
Arithmetic and numeric transforms: *, +, -, /, ^, cast, ceil, cos, floor, log, log10, mod, neg, sin, and sqrt.
Reference, creation, and value-state operations: const, dynamic, isConst, isDirty, isDynamic, isRef, isStatic, known?, new, newVarOfTheSameType, stable?, unconst, and unknownStable?.
Schema and struct introspection: code?, codeRef?, fieldCount, fieldIndex, fieldIsRef, fieldIsVirtual, fieldName, has, isCombined, managed?, same, schemaName, and virtual?.
Storage and manual lifetime operations: addressToReference, alignment, manuallyDestroyVariable, manuallyInitVariable, storageAddress, and storageSize.
Diagnostics and compile-time failure: failCompilation, getCallTrace, printCompilerMessage, printStack, printStackTrace, and raiseStaticError.

getCallTrace (-- callTrace)

Inputs

None.

Outputs

callTrace: Immutable Ref to the current top call-trace item, or known NIL of that Ref schema when unavailable.

getCallTrace returns the structured immutable Ref itself.

The result schema is an immutable Ref to the callTraceItem type. In formatted form, that referent schema is:

{ name: Text; line: Int32; column: Int32; prev: Natx; }

The referent fields mean:

name: Source text of the current node.

line: 1-based source line of that node.

column: 1-based source column of that node.

prev: Natx link to the previous call-trace item, or 0 when no older frame is present.

The structured result does not include a file path.

Behavior

If call-trace data is available, the builtin returns an unknown immutable Ref to the current top call-trace item.

If call-trace data is unavailable, the builtin returns a known NIL immutable Ref of the same schema.

The builtin has no inputs.

Example

{} 0 {} [ "-- immutable Ref result --" printCompilerMessage getCallTrace isConst printStack _:; getCallTrace printStack _:; 0 ] "main" exportFunction

Expected Output During Compilation

-- immutable Ref result -- TRUE { name: Text; line: Int32; column: Int32; prev: Natx; } CNIL