XLISP top-level

Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference

# 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

Nyquist / XLISP 2.0 - Contents | Tutorials | Examples | Reference