java.io
クラス SequenceInputStream

java.lang.Object
  |
  +--java.io.InputStream
        |
        +--java.io.SequenceInputStream

public class SequenceInputStream

extends InputStream

ほかの入力ストリームを論理的に連結したものを表します。このメソッドは、入力ストリームを集めて順序を付けたコレクションから、始めにその最初のストリームをファイルの終わりまで読み込み、次に 2 番目に移ります。これを繰り返して、最後の入力ストリームでファイルの終わりに達するまで順次読み込みます。

導入されたバージョン:

JDK1.0

コンストラクタの概要

SequenceInputStream(Enumeration e)
引数を記憶しておくことにより、新しく作成された SequenceInputStream を初期化します。

SequenceInputStream(InputStream s1, InputStream s2)
2 つの引数を記憶しておくことにより、新しく作成された SequenceInputStream を初期化します。

メソッドの概要

int	available() 現在のストリームにあるバイト数を返します。
void	close() この入力ストリームを閉じ、そのストリームに関連するすべてのシステムリソースを解放します。
int	read() この入力ストリームから、データの次のバイトを読み込みます。
int	read(byte[] b, int off, int len) この入力ストリームから len バイトまでのデータをバイトの配列に読み込みます。

クラス java.io.InputStream から継承したメソッド

mark, markSupported, read, reset, skip

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SequenceInputStream

public SequenceInputStream(Enumeration e)

引数を記憶しておくことにより、新しく作成された SequenceInputStream を初期化します。この引数は、実行時の型が InputStream であるオブジェクトを作成する Enumeration でなければなりません。列挙から作成された入力ストリームが順番に読み込まれ、それにより、この SequenceInputStream から読み込むバイトが提供されます。列挙からの各入力ストリームの読み込みが終わると、それぞれ close メソッドを呼び出して閉じられます。

パラメータ:

e - 入力ストリームの列挙

関連項目:

Enumeration

SequenceInputStream

public SequenceInputStream(InputStream s1,
                           InputStream s2)

2 つの引数を記憶しておくことにより、新しく作成された SequenceInputStream を初期化します。2 つの引数は、s1、s2 の順番で読み込まれ、それにより、この SequenceInputStream から読み込むバイトが提供されます。

パラメータ:

s1 - 読み込む最初の入力ストリーム

s2 - 読み込む 2 番目の入力ストリーム

メソッドの詳細

available

public int available()
              throws IOException

現在のストリームにあるバイト数を返します。

オーバーライド:

クラス InputStream 内の available

導入されたバージョン:

JDK1.1

read

public int read()
         throws IOException

この入力ストリームから、データの次のバイトを読み込みます。そのバイトは、0 〜 255 の範囲の int として返されます。ストリームの終わりに達してバイトがない場合は、値 -1 が返されます。このメソッドは、入力データが読み込めるようになるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

このメソッドは、現在のサブストリームから文字を 1 つ読み込もうとします。そのストリームの終わりに達すると、現在のサブストリームの close メソッドを呼び出して、次のサブストリームからの読み込みを開始します。

戻り値:

データの次のバイト。ストリームの終わりに達した場合は -1

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス InputStream 内の read

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

この入力ストリームから len バイトまでのデータをバイトの配列に読み込みます。このメソッドは、少なくとも 1 バイトの入力データが得られるようになるまでブロックします。最初の引数が null の場合は、len までのバイトを読み込んだあと廃棄されます。

SequenceInputStream の read メソッドは、現在のサブストリームからデータを読み込もうとします。そのストリームの終わりに達したために文字の読み込みに失敗すると、現在のサブストリームの close メソッドを呼び出して、次のサブストリームからの読み込みを開始します。

パラメータ:

b - データを読み込むバッファ

off - データの開始オフセット

len - 読み込むバイトの最大数

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス InputStream 内の read

close

public void close()
           throws IOException

この入力ストリームを閉じ、そのストリームに関連するすべてのシステムリソースを解放します。閉じられた SequenceInputStream は、入力処理を実行できません。また、それを開き直すこともできません。

この入力ストリームが列挙から作成された場合、InputStream の close メソッドが復帰する前に、残りのすべての要素が列挙から要求されて閉じられます。

例外:

IOException - 入出力エラーが発生した場合

オーバーライド:

クラス InputStream 内の close