type: function (subr) location: built-in source file: xlbfun.c and xldbug.c Common LISP compatible: no supported on: all machines
The TOP-LEVEL function aborts to the top level of XLISP. This may be from within several levels of the break loop. This is valid for BREAKs, ERRORs and CERRORs (continuable errors). If TOP-LEVEL is evaluated while not in a break loop, a message is printed - "[ back to the top level ]". This message does not cause XLISP to go into a break loop. TOP-LEVEL never actually returns a value.
(top-level) ; [ back to the top level ] ; (break "out") ; break: out (1st) (break "twice") ; break: twice (2nd) (top-level) ; to exit out of break loop
KEYSTROKE EQUIVALENT: In the IBM PC and MS-DOS versions of XLISP, a CTRL-c key sequence has the same effect as doing a (TOP-LEVEL). On a Macintosh, this can be accomplished by a pull-down menu or a COMMAND-t.