Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

terpri

terpri

type: function (subr) 
location: built-in
source file: xlfio.c  and  xlprin.c
Common LISP compatible: yes
supported on: all machines

SYNTAX

(terpri  [ <destination> ] )
        <destination>   -       an optional destination - must be a file pointer
                                or stream, the default is *standard-output*

DESCRIPTION

The TERPRI function prints a new-line to the specified <destination>. This will terminate the current print line for <destination>. NIL is always returned as the result. The <destination> may be a file pointer or a stream. If there is no <destination>, *STANDARD-OUTPUT* is the default.

EXAMPLES

(terpri)                                ; prints  <NL>
                                        ;
(setq f (open "pr" :direction :output )); create a file
(princ "hi" f)                          ; returns "hi"
(princ 727 f)                           ; returns 727
(princ "ho" f)                          ; returns "ho"
(terpri f)                              ; returns NIL
(close f)                               ; file contains hi727ho\n

COMMON LISP COMPATIBILITY: Common LISP specifies that print operations with a <destination> of NIL, will go to *STANDARD-OUTPUT*. XLISP does not send the output to *STANDARD-OUTPUT* with a <destination> of NIL. Common LISP also specifies that a <destination> of T will be sent to *TERMINAL-IO*. XLISP does not allow T as a valid argument for <destination>.


Go to the first, previous, next, last section, table of contents.