write-string (ANSI and GNU Common Lisp Document)

Next: read-sequence, Previous: read-line, Up: Streams Dictionary

#### 21.2.23 write-string, write-line [Function]

`write-string` string &optional output-stream &key start end ⇒ string

`write-line` string &optional output-stream &key start end ⇒ string

#### Arguments and Values::

string—a string.

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

start, end—bounding index designators of string. The defaults for start and end are `0` and nil, respectively.

#### Description::

write-string writes the characters of the subsequence of string bounded by start and end to output-stream. write-line does the same thing, but then outputs a newline afterwards.

#### Examples::

     (prog1 (write-string "books" nil :end 4) (write-string "worms"))
     |>  bookworms
    ⇒  "books"
     (progn (write-char #\*)
            (write-line "test12" *standard-output* :end 5)
            (write-line "*test2")
            (write-char #\*)
            nil)
     |>  *test1
     |>  *test2
     |>  *
    ⇒  NIL

#### Affected By::

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

#### See Also::

read-line , write-char

#### Notes::

write-line and write-string return string, not the substring bounded by start and end.

     (write-string string)
    ≡ (dotimes (i (length string)
          (write-char (char string i)))

     (write-line string)
    ≡ (prog1 (write-string string) (terpri))