GEOS SDK TechDocs

Swat Command Reference

addr-parse ...

_print

 _print <expression>

Examples:

"_print ax-10"

print ax less 10 decimal.

Print the value of an expression.

The difference between this command and the "print" command is a subtle one: if one of the arguments contains square-brackets, the Tcl interpreter will attempt to evaluate the text between the brackets as a command before _print is given the argument. If the text between the brackets is intended to be an array index, the interpreter will generate an error before the Swat expression evaluator has a chance to decide whether the text is a nested Tcl command or an array index.

For this reason, this function is intended primarily for use by Tcl procedures, not by users.

See Also: print, addr-parse.

abort

abort [<frame-number>]
abort [<function>]

Examples:

"abort"

abort executing the current frame.

"abort 3"

abort executing up through the third frame.

"abort ObjMessage"

abort executing up through first ObjMessage.

Abort code execution up through a given frame or routine. By "abort", we me "do not execute". This can be quite dangerous, as semaphores may not be ungrabbed, blocks not unlocked, flags not cleared, etc., leaving the state of objects, and if executing system code, possibly the system itself in a bad state. This command should only be used when the only alternative is to to detach (i.e. in a fatal error) as a way to possibly prolong the usefulness of the debugging session.

• If no argument is given, code through the current frame is aborted.
• <frame num> are the numbers that appear at the left of the backtrace.

See Also: finish, backtrace.

abortframe

abortframe <frame-token>

Examples:

"abortframe $cur"

Abort all code execution through the frame whose token is in $cur.

Aborts code execution up through a particular stack frame. As no code is executed, the registers may be in a garbaged state.

• The argument is a frame token, as returned by the "frame" command.
• No FULLSTOP event is dispatched when the machine actually aborts executing in the given frame. The caller must dispatch it itself, using the "event" command. For information about FULLSTOP events, see the event Tcl command.
• The command returns zero if the machine aborted executing in the given frame; non-zero if it was interrupted before that could happen.

GEOS SDK TechDocs

Swat Command Reference

addr-parse ...