JavaTM Platform
Standard Ed. 6

java.io
クラス SequenceInputStream

java.lang.Object
  上位を拡張 java.io.InputStream
      上位を拡張 java.io.SequenceInputStream
すべての実装されたインタフェース:
Closeable

public class SequenceInputStream
extends InputStream

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

導入されたバージョン:
JDK1.0

コンストラクタの概要
SequenceInputStream(Enumeration<? extends InputStream> 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<? extends InputStream> e)
引数を記憶しておくことにより、新しく作成された SequenceInputStream を初期化します。この引数は、実行時の型が InputStream であるオブジェクトを生成する Enumeration でなければなりません。この SequenceInputStream から読み込まれるバイトを提供するために、列挙によって作成された入力ストリームが順番に読み込まれます。列挙からの各入力ストリームの読み込みが終わると、それぞれ close メソッドの呼び出しにより閉じられます。

パラメータ:
e - 入力ストリームの列挙
関連項目:
Enumeration

SequenceInputStream

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

パラメータ:
s1 - 読み込む最初の入力ストリーム
s2 - 読み込む 2 番目の入力ストリーム
メソッドの詳細

available

public int available()
              throws IOException
現在の基本となる入力ストリームに対するメソッドの次の呼び出しによって、ブロックせずに現在の基本となる入力ストリームから読み込むことができる (またはスキップできる) 推定バイト数を返します。次の呼び出しは、同じスレッドの場合も別のスレッドの場合もあります。このような多数のバイトを 1 回で読み込んだりスキップしたりすることでブロックすることはありませんが、読み込むまたはスキップするバイト数が少なくなることがあります。  

このメソッドは、現在の基本となる入力ストリームの available を単純に呼び出し、結果を返します。

オーバーライド:
クラス InputStream 内の available
戻り値:
ブロックせずに現在の基本となる入力ストリームから読み込むことができる (またはスキップできる) 推定バイト数、またはこの入力ストリームが close() メソッドの呼び出しによって閉じられた場合は 0
例外:
IOException - 入出力エラーが発生した場合
導入されたバージョン:
JDK1.1

read

public int read()
         throws IOException
この入力ストリームからデータの次のバイトを読み込みます。バイトは、0255 の範囲の int として返されます。ストリームの終わりに達したために読み込むバイトがない場合は、値 -1 が返されます。入力データが読み込めるようになるか、ファイルの終わりが検出されるか、または例外が発生するまで、このメソッドはブロックされます。  

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

定義:
クラス InputStream 内の read
戻り値:
データの次のバイト。ストリームの終わりに達した場合は -1
例外:
IOException - 入出力エラーが発生した場合

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException
最大 len バイトまでのデータを、この入力ストリームからバイト配列に読み込みます。len が 0 でない場合、このメソッドは入力の少なくとも 1 バイトが利用できるようになるまでブロックします。そうでない場合、バイトは読み込まれず、0 が返されます。  

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

オーバーライド:
クラス InputStream 内の read
パラメータ:
b - データの読み込み先のバッファー
off - データが書き込まれる配列 b の開始オフセット
len - 読み込まれる最大バイト数
戻り値:
読み込まれるバイト数
例外:
NullPointerException - bnull の場合
IndexOutOfBoundsException - off が負の場合、len が負の場合、または lenb.length - off よりも大きい場合
IOException - 入出力エラーが発生した場合
関連項目:
InputStream.read()

close

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

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

定義:
インタフェース Closeable 内の close
オーバーライド:
クラス InputStream 内の close
例外:
IOException - 入出力エラーが発生した場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。