ColdC: Function/Method Reference: traceback()

LIST traceback()

This function returns the propogated error stack. The first element in the traceback list is the error condition, the second element is what caused the error. The subsequent errors describe the method call stack from the point of origin.

The error condition list is ordered as follows:

ERROR code
STRING explanation
ANY additional

An example of the error condition would be [~methodnf, "$sys.splat() not found.", 0].

The second element (what caused the error) will vary, depending upon where the error came from. If the error came from an operator, function or native method, it is a two element list:

SYMBOL which is one of 'opcode, 'function or 'native
SYMBOL what operator, or the name of the function/native method.

If the error originated in a method, this list is ordered as:

'method
SYMBOL method name
OBJNUM current object
OBJNUM defining object
INTEGER line in method

All other elements are ordered as:

ERROR error code
SYMBOL method name
OBJNUM current object
OBJNUM defining object
INTEGER line in method

Keep in mind that the error code will change to ~methoderr when it propogates, unless you specifically handle it. See the section Errors for more information. control it