22.8

java.io.SequenceInputStream

THE PACKAGE JAVA.IO

22.8 The Class

java.io.SequenceInputStream

A

SequenceInputStream

 represents the logical concatenation of other input

streams. It starts out with an ordered collection of input streams and reads from

the first one until end of file is reached, whereupon it reads from the second one,

and so on, until end of file is reached on the last of the contained input streams.

public class SequenceInputStream extends InputStream {

public SequenceInputStream(Enumeration e);

public SequenceInputStream(InputStream s1, InputStream s2);

public int read() throws IOException;

public int read(byte[] buf, int pos, int len)

throws IOException, NullPointerException,

IndexOutOfBoundsException;

public void close() throws IOException;

}

22.8.1

public SequenceInputStream(Enumeration e)

This constructor initializes a newly created

SequenceInputStream

 by remem 

bering the argument, which must be an

Enumeration

 ( 21.1) that produces

objects whose run time type is

InputStream

 ( 22.3). The input streams that are

produced by the enumeration will be read, in order, to provide the bytes to be read

from this

SequenceInputStream

. After each input stream from the enumeration

is exhausted, it is closed by calling its

close

 method.

22.8.2

public SequenceInputStream(InputStream s1,

InputStream s2)

This constructor initializes a newly created

SequenceInputStream

 by remem 

bering the two arguments, which will be read in order, first

s1

 and then

s2

, to pro 

vide the bytes to be read from this

SequenceInputStream

.

22.8.3

public int read() throws IOException

Implements the

read

 method of

InputStream

 ( 22.3.1).

694