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.48 get-output-stream-string Function

Syntax:
get-output-stream-string string-output-stream    string

Arguments and Values:
string-output-stream - a stream.

string - a string.

Description:
Returns a string containing, in order, all the characters that have been output to string-output-stream. This operation clears any characters on string-output-stream, so the string contains only those characters which have been output since the last call to get-output-stream-string or since the creation of the string-output-stream, whichever occurred most recently.

Examples:
 (setq a-stream (make-string-output-stream)
        a-string "abcdefghijklm")  "abcdefghijklm"
 (write-string a-string a-stream)  "abcdefghijklm"
 (get-output-stream-string a-stream)  "abcdefghijklm"
 (get-output-stream-string a-stream)  ""

Side Effects:
The string-output-stream is cleared.

Exceptional Situations:
The consequences are undefined if stream-output-string is closed.

The consequences are undefined if string-output-stream is a stream that was not produced by make-string-output-stream. The consequences are undefined if string-output-stream was created implicitly by with-output-to-string or format.

See Also:
make-string-output-stream

Allegro CL Implementation Details:
None.

Home Previous Up Next Table of Contents Index
© Franz Inc. 1998-2015 - File last updated 03-23-2015