return codes

A convenience: we need these return codes in many different bytecode files.

exception handling macros

Exception creation can be fairly verbose. These macros provide an API of sorts to the exceptions.

catch ()

Preamble for any tcl-related exception handler.

rethrow ()

Re-throw the current exception

get_stacktrace (OUT string message)

(XXX) return the stacktrace for the current exception

get_message (OUT string message)

Get the simple string message for the current exception.

get_severity (OUT int level)

Get the severity level of the current exception.

get_return_code

Get the tcl-level code for this exception. (TCL_CATCH, TCL_RETURN), etc. Note that TCL_OK is not one of the options here: that's implied by a normal parrot .return

throw (IN string mess)

Given a string, construct and throw a TCL_ERROR.

throw_with_code (IN int code, IN string mess)

Throw an arbitrary TCL_ERROR, TCL_CONTINUE, etc, with a given message.

tcl_break ()

Generate a TCL_BREAK with no message.

tcl_continue ()

Generate a TCL_BREAK with no message.

tcl_return (IN any value)

Generate a TCL_RETURN with the given return value.

Utility methods

the implementation of these never change: define them once and just include them.

cloneable ()

Simplistic implementation of __clone