CLHS: System Class CONCATENATED-STREAM

#

System Class CONCATENATED-STREAM

Class Precedence List:

concatenated-stream, stream, t

Description:

A concatenated stream is an input stream which is a composite stream of zero or more other input streams, such that the sequence of data which can be read from the concatenated stream is the same as the concatenation of the sequences of data which could be read from each of the constituent streams.

Input from a concatenated stream is taken from the first of the associated input streams until it reaches end of file[1]; then that stream is discarded, and subsequent input is taken from the next input stream, and so on. An end of file on the associated input streams is always managed invisibly by the concatenated stream---the only time a client of a concatenated stream sees an end of file is when an attempt is made to obtain data from the concatenated stream but it has no remaining input streams from which to obtain such data.

See Also:

concatenated-stream-streams, make-concatenated-stream

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

- STREAM-ACCESS:ADD-TYPES-ACCESSORS
- TYPE-OF-AND-PREDEFINED-CLASSES:UNIFY-AND-EXTEND

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