terpri (ANSI and GNU Common Lisp Document)

Next: unread-char, Previous: read-char-no-hang, Up: Streams Dictionary

#### 21.2.19 terpri, fresh-line [Function]

`terpri` &optional output-stream ⇒ nil

`fresh-line` &optional output-stream ⇒ generalized-boolean

#### Arguments and Values::

output-stream – an output stream designator. The default is standard output.

generalized-boolean—a generalized boolean.

#### Description::

terpri outputs a newline to output-stream.

fresh-line is similar to terpri but outputs a newline only if the output-stream is not already at the start of a line. If for some reason this cannot be determined, then a newline is output anyway. fresh-line returns true if it outputs a newline; otherwise it returns false.

#### Examples::

     (with-output-to-string (s)
        (write-string "some text" s)
        (terpri s)
        (terpri s)
        (write-string "more text" s))
    ⇒  "some text

    more text"
     (with-output-to-string (s)
        (write-string "some text" s)
        (fresh-line s)
        (fresh-line s)
        (write-string "more text" s))
    ⇒  "some text
    more text"

#### Side Effects::

The output-stream is modified.

#### Affected By::

*standard-output*, *terminal-io*.

#### Exceptional Situations::

None.

[Reviewer Note by Barmar: What if stream is closed?]

#### Notes::

terpri is identical in effect to

     (write-char #\Newline output-stream)