CLHS: Function WRITE-STRING, WRITE-LINE

#

Function WRITE-STRING, WRITE-LINE

Syntax:

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

Side Effects: None.

Affected By:

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

Exceptional Situations: None.

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))

The following X3J13 cleanup issues, not part of the specification, apply to this section:

- RANGE-OF-START-AND-END-PARAMETERS:INTEGER-AND-INTEGER-NIL
- SUBSEQ-OUT-OF-BOUNDS

Copyright 1996-2005, LispWorks Ltd. All rights reserved.