String Stream Functions

These functions operate on unnamed streams. An unnamed output stream collects characters sent to it when it is used as the destination of any output function. The functions 'get-output- stream-string' and string or a list of characters.

An unnamed input stream is setup with the 'make-string-input- stream' function and returns each character of the string when it is used as the source of any input function.

(make-string-input-stream <str> [<start> [<end>]])
    <str>       the string
    <start>     the starting offset
    <end>       the ending offset + 1
    returns     an unnamed stream that reads from the string

(make-string-output-stream)
    returns     an unnamed output stream

(get-output-stream-string <stream>)
    <stream>    the output stream
    returns     the output so far as a string
  Note:  the output stream is emptied by this function

(get-output-stream-list <stream>)
    <stream>    the output stream
    returns     the output so far as a list
  Note:  the output stream is emptied by this function