XLISP dribble

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

# dribble

Type: | - | function (subr)
Source: | - | xlisp.c, xlsys.c, msstuff.c

## Syntax

(dribble [file-str])
  file-str - a string expression for a file name
  returns - T if the transcript is opened, NIL if it is closed

## Description

The 'dribble' function, when called with a 'file-str' argument, opens the specified file and records a transcript of the XLISP session. When 'dribble' is called with no 'file-str' argument, it closes the current transcript file [if any]. 'dribble' will return T if the specified 'file-str' was successfully opened. It will return a NIL if the 'file-str' was not opened successfully or if 'dribble' was evaluated to close a transcript.

## Examples

    (dribble "my-trans-file")  ; open file "my-trans-file"
                               ;   for a session transcript
    (+ 2 2)
    (dribble)                  ; close the transcript

Note: It is also possible to start a transcript when invoking XLISP. To start XLISP with a transcript file of 'myfile' type in 'xlisp -tmyfile'. [I haven't tested this with Nyquist.]

See the dribble function in the XLISP 2.0 manual.

Back to Top

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