make-broadcast-stream

ToC

Allegro CL

ANSI Common Lisp

21 Streams

21.2 Dictionary of Streams

21.2.41 make-broadcast-stream

Function

Syntax:

make-broadcast-stream &rest streams

broadcast-stream

Arguments and Values:

stream - an output stream.

broadcast-stream - a broadcast stream.

Description:

Returns a broadcast stream.

Examples:

 (setq a-stream (make-string-output-stream)
        b-stream (make-string-output-stream))  #<String Output Stream>
 (format (make-broadcast-stream a-stream b-stream)
          "this will go to both streams")   NIL
 (get-output-stream-string a-stream)  "this will go to both streams"
 (get-output-stream-string b-stream)  "this will go to both streams"

Exceptional Situations:

Should signal an error of type type-error if any stream is not an output stream.

See Also:

broadcast-stream-streams

Allegro CL Implementation Details:

None.