CLHS: Function MAKE-STRING-OUTPUT-STREAM

#

Function MAKE-STRING-OUTPUT-STREAM

Syntax:

make-string-output-stream `&key` element-type => string-stream

Arguments and Values:

element-type---a type specifier. The default is character.

string-stream---an output string stream.

Description:

Returns an output string stream that accepts characters and makes available (via get-output-stream-string) a string that contains the characters that were actually output.

The element-type names the type of the elements of the string; a string is constructed of the most specialized type that can accommodate elements of that element-type.

Examples:

     (let ((s (make-string-output-stream)))
       (write-string "testing... " s)
       (prin1 1234 s)
       (get-output-stream-string s))
    =>  "testing... 1234"

Affected By: None.

Exceptional Situations: None.

See Also:

get-output-stream-string, with-output-to-string

Notes: None.

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

- STREAM-ACCESS:ADD-TYPES-ACCESSORS
- CHARACTER-PROPOSAL:2-5-6

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