top-level

Type:	-	function (subr)
Source:	-	xlbfun.c, xldbug.c

Syntax

(top-level)

returns - never returns

Description

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 top level ]

This message does not cause XLISP to go into a break loop. The 'top-level' function never actually returns a value.

Examples

(top-level)      ; [ back to top level ]

(break "out")    ; break: out    (1st)
(break "twice")  ; break: twice  (2nd)
(top-level)      ; to exit out of the break loop

Keyboard: 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'. [I haven't tested this with Nyquist.]

See the top-level function in the XLISP 2.0 manual.

  Back to Top