ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   21 Streams   21.2 Dictionary of Streams

21.2.23 write-string, write-line Function

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

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

Allegro CL Implementation Details:
None.


Home Previous Up Next Table of Contents Index
© Franz Inc. 1998-2009 - File last updated 7-21-2009