CLCS
src report error
Index
read-line Streams Dictionary read-sequence
Function

write-string, write-line

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

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

Arguments and Values

stringa string.
output-stream an output stream designator. The default is standard output.
start, endbounding 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))

Backlinks

Input, Output, and Bidirectional Streams, pprint-logical-block, Stream Arguments to Standardized Functions, Streams Dictionary, Symbols in the COMMON-LISP Package, write-sequence