22. パッケージjava.io

Javaの入出力は，ストリームの考え方の下に作られている。ストリームは，時間と共に読み込み又は書き込みされる一般的には8ビットが1バイトのデータの並びとする。

パッケージ java.ioでは，すべての入力は，抽象クラスである InputStream のサブクラスを通じて行われ，すべての出力は，抽象クラスである OutputStream のサブクラスを通じて行われる。この規則の唯一の例外は，クラス RandomAccessFile とする。このクラスは，ランダムアクセス及びおそらく読み書きが混合したファイルの読み書きができる。

入力ストリームに対しては，データの入力源は，ファイル，String，バイトの配列，出力ストリームに書き出されたバイト列(一般的には，他のスレッドによって行われる)などである。入力ストリームを受け取って別の入力に渡す前に，変換又は拡張を行う“フィルタ入力ストリーム”もある。例えば，LineNumberInputStream は，データを逐語的にそのまま通すが，改行をカウントする。

出力ストリームに対しては，データの出力先は，ファイル，バイトの配列，入力ストリームとして読まれるバッファ(一般的には，他のスレッドによって行われる)などである。別の出力ストリームに書き出す前に，データの変換又は拡張を行う“フィルタ出力ストリーム”もある。

クラス File のインスタンスは，ファイルシステムの特定のファイルを識別するためのパス名(文字列)を表す。ファイル名の変更又は削除などのファイルシステムに対する特定の操作は，ストリームを通じてではなく，このクラスで行われる。

クラス FileDescriptor のインスタンスは，ファイルシステム内の特定のファイルの抽象的な表示を表す。このようなファイル記述子は，Java I/Oシステムによって内部的に生成される。

長整数，浮動小数点数，及び文字列のような，バイト又は文字以外のデータの転送を支援する二つのインタフェース DataInput 及び DataOutput もある。クラス DataInputStream は，インタフェース DataInput を実装し，クラス DataOutputStream は，インタフェース DataOutput を実装する。クラス RandomAccessFile は，DataInput及びDataOutputの両方を実装する。

クラス StreamTokenizer は，入力ストリームからのバイト列又は文字列を解析して，識別子，数値，文字列などのトークンに分割する簡単な支援を提供する。オプションで注釈を無視したり，オプションで改行を認識又は無視したりする。

パッケージ java.io で定義されているクラス階層は，次の通りとする。 (ボールド体で示したものがパッケージ java.io のクラスであり，他のものは，パッケージ java.lang のクラスである。サブクラスの関係をはっきりさせるためにここに示している)

Object                                               20.1
    interface DataInput                              22.1
    interface DataOutput                             22.2
    InputStream                                      22.3
        FileInputStream                              22.4
        PipedInputStream                             22.5
        ByteArrayInputStream                         22.6
        StringBufferInputStream                      22.7
        SequenceInputStream                          22.8
        FilterInputStream                            22.9
            BufferedInputStream                      22.10
            DataInputStream                          22.11
            LineNumberInputStream                    22.12
            PushBackInputStream                      22.13
    StreamTokenizer                                  22.14
    OutputStream                                     22.15
        FileOutputStream                             22.16
        PipedOutputStream                            22.17
        ByteArrayOutputStream                        22.18
        FilterOutputStream                           22.19
            BufferedOutputStream                     22.20
            DataOutputStream                         22.21
            PrintStream                              22.22
    RandomAccessFile                                 22.23
    File                                             22.24
    interface FileNameFilter                         22.25
    FileDescriptor                                   22.26
    Throwable                                        20.22
        Exception                                    20.22
            IOException                              22.27
                EOFException                         22.28
                FileNotFoundException                22.29
                InterruptedIOException               22.30
                UTFDataFormatException               22.31

22.1 インタフェース `java.io.DataInput`

インタフェース DataInputは，バイナリストリームからバイト列を読み込み，それらのデータを任意のJavaのプリミティブ型に再構成する方法を提供する。 Java修正版UTF-8形式のデータから String を再構成するための機能もある。

インタフェース DataOutput (22.2)は，インタフェース DataInput で読み戻すのに適しているバイナリ出力データの生成を支援する。

インタフェース DataInput は，クラス DataInputStream(22.11)及びRandomAccessFile(22.23)によって実装されている。

public interface DataInput {
    public void readFully(byte[] b)
        throws IOException, NullPointerException;
    public void readFully(byte[] b, int off, int len)
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public int skipBytes(int n) throws IOException;
    public boolean readBoolean() throws IOException;
    public byte readByte() throws IOException;
    public int readUnsignedByte() throws IOException;
    public short readShort() throws IOException;
    public int readUnsignedShort() throws IOException;
    public char readChar() throws IOException;
    public int readInt() throws IOException;
    public long readLong() throws IOException;
    public float readFloat() throws IOException;
    public double readDouble() throws IOException;
    public String readLine() throws IOException;
    public String readUTF() throws IOException;
}

一般的に，このインタフェースの中の読み込みルーチンは，期待する数のバイトを読み込む前にファイルの終わりに達すると，EOFException(IOException の一種)を投げる。ファイルの終わり以外の理由で読み込みに失敗した場合は，EOFException ではなく IOExceptionを投げる。特に，入力ストリームが閉じられている(22.3.6) 時には，IOExceptionを投げる。

22.1.1public void readFully(byte[] b) throws IOException, NullPointerException;

readFully(b) は，入力ストリームからいくつかのバイトを読み，それをバッファ配列 b に格納する。読まれたバイト数は，配列 b の長さに等しい。

このメソッドは，次のどれかの状態になるまでブロックする。

入力データの b.length だけのバイトが有効なとき。この場合は，正常に戻る。
ファイルの終わりが検出されたとき。この場合は，EOFException を投げる。
入出力エラーが発生したとき。この場合は， EOFException ではなく IOException を投げる。

b が null ならば，NullPointerException を投げる。

b.length が0ならば，バイトは読み込まない。そうでなければ，読み込んだ最初のバイトは，要素b[0]に，次のものは，b[1]にと順次格納する。

このメソッドから例外を投げた場合は，入力ストリームからのデータによって，bの全部ではなく一部が更新される可能性がある。

22.1.2 public void readFully(byte[] b, int off, int len) throws IOException, NullPointerException, IndexOutOfBoundsException

readFully(b, off, len) は，入力ストリームから lenバイト分を読み込む。

このメソッドは，次のいずれかの状態が発生するまでブロックする。

入力データの len バイト分が有効なとき。この場合は，正常に戻る。
ファイルの終わりを検出したとき。この場合は， EOFException を投げる。
入出力エラーが発生したとき。この場合は，EOFException ではなく IOException を投げる。

b が null ならば，NullPointerException を投げる。

off 若しくは len が負の数の時又はoff+len が配列 b の長さより大きい場合は，IndexOutOfBoundsException を投げる。

len が0の時，バイトは読み込まない。そうでなければ，読み込んだ最初のバイトは，要素b[off]に，次のものは，b[off+1]にと順次格納する。読み込まれるバイト数は，高々 len とする。

このメソッドから例外を投げた場合は，入力ストリームからのデータによって，b[off] から b[off+len-1]までの全部ではなく一部が更新される可能性がある。

22.1.3 public int skipBytes(int n) throws IOException

skipBytes は，入力ストリームからのデータを n バイト分スキップし，スキップしたバイト列を捨てる。しかしながら， n より少ないバイト数をスキップするかもしれず，ゼロであることもあり得る。これは，いくつかの状態から生じる。 n バイトをスキップする前にファイルの終わりに達することは，そのうちの一つの可能性である。このメソッドは，決して EOFException を投げない。実際にスキップしたバイト数を返す。

22.1.4 public boolean readBoolean() throws IOException

readBoolean は，1バイトを読み込み，そのバイトが非ゼロ値ならば true を返す。そのバイトがゼロならば，false を返す。

このメソッドは，インタフェース DataOutput のメソッド writeBoolean (22.2.4)の出力を読み込むのに適している。

22.1.5 public byte readByte() throws IOException

readByte は，1バイトを読み込み，それを返す。そのバイトは， -128 から 127 までの符合付きの値として扱われる。

このメソッドは，インタフェース DataOutput のメソッド writeByte (22.2.5)の出力を読み込むのに適している。

22.1.6 public int readUnsignedByte() throws IOException

readUnsignedByte は，1バイトを読み込み，型 int へのゼロ拡張を行い，その結果を返す。結果は，0 から 255 までの範囲の値とする。

このメソッドは，インタフェース DataOutput のメソッド writeByte(22.2.5)に対する実引数が，0 から 255 までの範囲であるときの出力を読み込むのに適している。

22.1.7 public short readShort() throws IOException

readShort は，2バイトを読み込み，型 short の値を返す。 a を読み込んだ最初のバイト，b を2番目のバイトとすると，次の値を返す。

(short)((a << 8) | (b & 0xff))

このメソッドは，インタフェース DataOutput のメソッド writeShort (22.2.6)の出力を読み込むのに適している。

22.1.8 public int readUnsignedShort() throws IOException

readUnsignedShort は，2バイトを読み込み，0 から 65535 までの範囲の型 int の値を返す。 a を読み込んだ最初のバイト，b を2番目のバイトとすると，次の値を返す。

(((a & 0xff) << 8) | (b & 0xff))

このメソッドは，インタフェース DataOutput のメソッド writeShort の (22.2.6)に対する実引数が，0 から 65535 までの範囲であるときの出力を読み込むのに適している。

22.1.9 public char readChar() throws IOException

readChar は，2バイトを読み込み，型 char の値を返す。 a を読み込んだ最初のバイト，b を2番目のバイトとすると，次の値を返す。

(char)((a << 8) | (b & 0xff))

このメソッドは，インタフェース DataOutput のメソッド writeChar (22.2.7) の出力を読み込むのに適している。

22.1.10 public int readInt() throws IOException

readInt は，4バイトを読み込み，型 int の値を返す。 aを読み込んだ最初のバイト，bを2番目のバイト，cを3番目のバイト，dを4番目のバイトとすると，次の値を返す。


(((a & 0xff) << 24) | ((b & 0xff) << 16) |
  ((c & 0xff) <<    8) | (d & 0xff))

このメソッドは，インタフェース DataOutput のメソッド writeInt (22.2.8) の出力を読み込むのに適している。

22.1.11 public long readLong() throws IOException

readLong は，8バイトを読み込み，型 long の値を返す。 aを読み込んだ最初のバイト，bを2番目のバイト，cを3番目のバイト，dを4番目のバイト，eを5番目のバイト，fを6番目のバイト，gを7番目のバイト，hを8番目のバイトとすると，次の値を返す。


(((long)(a & 0xff) << 56) |
  ((long)(b & 0xff) << 48) |
  ((long)(c & 0xff) <<  40) |
  ((long)(d & 0xff) << 32) |
  ((long)(e & 0xff) <<  24) |
  ((long)(f & 0xff) << 16) |
  ((long)(g & 0xff) <<   8) |
  ((long)(h & 0xff)))

このメソッドは，インタフェース DataOutput のメソッド writeLong (22.2.9)の出力を読み込むのに適している。

22.1.12 public float readFloat() throws IOException

readFloat は，4バイトを読み込み，型 float の値を返す。まず始めに，型 int の値を，メソッド readInt (22.1.10) と同じ方法で作成し，メソッド Float.intBitsToFloat (20.9.23) と同じ方法で，この型 int の値を型 float の値に変換する。

このメソッドは，インタフェース DataOutput のメソッド writeFloat (22.2.10) の出力を読み込むのに適している。

22.1.13 public double readDouble() throws IOException

readDouble は，8バイトを読み込み，型 double の値を返す。まず，メソッド readlong (22.1.11) と同じ方法で，型 long の値を作り，それを型 long から型 double へ，メソッド Double.longBitsToDouble (20.10.22) と同じ方法で変換する。

このメソッドは，インタフェース DataOutput のメソッド writeDouble (22.2.11) の出力を読み込むのに適している。

22.1.14 public String readLine() throws IOException

readLine は，連続したバイト列を読み込む。それぞれのバイトを，改行又はファイルの終わりに達するまで，別々に文字に置き換え，読み込んだ文字を型 String の値として返す。このメソッドは，バイトを処理するので，完全なUnicode文字セットをサポートしていないことに注意のこと。

1バイトも読み込まない以前に，ファイルの終わりに達すると，null を返す。そうでなければ，読み込んだすべてのバイトをゼロ拡張し型 char に変換する。 "\n" を検出すると，それを捨てて読み込みを終了する。 "\r" を検出すると，それを捨て，その次のバイトが "\n" に変換されるならば，それも捨てる。それから，読み込みを終了する。 "\n" 及び "\r" のいずれかを検出する前に，ファイルの終わりに達した場合は，そこで読み込みを終了する。読み込みを終了すると，読み込んで捨てられなかったすべての文字を読み込んだ順に含む，型 String の値を返す。この文字列中のすべての文字は，\u0100，つまり (char)256，未満の値をもつことに注意のこと。

22.1.15 public String readUTF() throws IOException

readUTF は，Java修正版UTF-8形式で符号化されたUnicode文字列表記を読み込み，この文字列を型 String として返す。

最初の2バイトを読み込み，メソッド readUnsignedShort (22.1.8)と同じ方法で，符号なしの16ビット整数を構築する。この整数値は， UTF長(UTF length) と呼ばれ，あと何バイトを読み込まなければならないかを示す。それから，これらのバイトは，それらをグループと考えることによって文字に変換される。各グループの長さは，グループの最初のバイトの値によって計算する。あるグループに続くバイトが，もしあれば，それは，次のグループの最初のバイトとする。

グループの最初のバイトが，ビットパターン 0xxxxxxx（ここで，xは，0又は1を意味する）に一致するならば，そのグループは，そのバイトだけから成る。そのバイトは，文字を形成するためにゼロ拡張される。

グループの最初のバイトが，ビットパターン 110xxxxx に一致するならば，そのグループは，そのバイト a 及び2番目のバイト b から成る。 b がない場合(a が読み込んだバイトの最後の場合)又はb がビットパターン 10xxxxxxx に一致しない場合は，UTFDataFormatException を投げる。そうでなければ，そのグループを，次の通り文字に変換する。

(char)(((a & 0x1F) << 6) | (b & 0x3F))

グループの最初のバイトが，ビットパターン 1110xxxx に一致するならば，そのグループは，そのバイト a 並びにもう二つのバイト b 及び c から成る。 c がない場合(a が，読み込んだバイトの最後の二つのどちらかの場合)，又はb 若しくは c が，ビットパターン 10xxxxxx に一致しない場合は，UTFDataFormatException を投げる。そうでなければ，そのグループを，次の通り文字に変換する。

(char)(((a & 0x0F) << 12) | ((b & 0x3F) << 6) | (c & 0x3F))

グループの最初のバイトが，ビットパターン 1111xxxx 又は10xxxxxx に一致する場合は，UTFDataFormatException を投げる。

この手順の途中でファイルの終わりを検出した場合は，EOFException を投げる。

この手順によって，すべてのグループを文字に変換した後に，関連するグループを入力ストリームから読み込んだ順番と同じ順番で，それらの文字を集めてStringを形成し，それを返す。

このメソッドによる読み込みに適しているデータを書き出すために，インタフェース DataOutput のメソッド writeUTF (22.2.14) を使用できる。

22.2 インタフェース `java.io.DataOutput`

DataOutput インタフェースは，任意のJavaのプリミティブ型を，バイト列に変換しバイナリストリームに書き出す。 String をJava修正版UTF-8形式に変換して書き出す機能ももつ。

DataOutput インタフェースが書き出したバイナリ出力からJavaのデータを読み込み，再構成するためには，DataInput インタフェースを用いる(22.1)。

DataOutputインタフェースは，クラス DataOutputStream (22.21)及びクラス RandomAccessFile (22.23)で実装されている。

public interface DataOutput {
	public void write(int b) throws IOException;
	public void write(byte[] b)
		throws IOException, NullPointerException;
	public void write(byte[] b, int off, int len)
		throws IOException, NullPointerException,
			IndexOutOfBoundsException;
	public void writeBoolean(boolean v) throws IOException;
	public void writeByte(int v) throws IOException;
	public void writeShort(int v) throws IOException;
	public void writeChar(int v) throws IOException;
	public void writeInt(int v) throws IOException;
	public void writeLong(long v) throws IOException;
	public void writeFloat(float v) throws IOException;
	public void writeDouble(double v) throws IOException;
	public void writeBytes(String s)
		throws IOException, NullPointerException;
	public void writeChars(String s)
		throws IOException, NullPointerException;
	public void writeUTF(String s)
		throws IOException, NullPointerException;
}

このインタフェースの中のすべてのメソッドは，バイトを書き出すものとする。一般的に，何らかの理由でバイトを書き出せない場合，IOException を投げる。

22.2.1 public void write(int b) throws IOException

write は，1バイトを出力ストリームに書き出す。書き出すバイトは，実引数 b の下位8ビットとする。上位24ビットは，無視される。

22.2.2 public void write(byte[] b) throws IOException, NullPointerException

write は，配列 b のバイト列をその順番に書き出す。

b が null ならば，NullPointerException を投げる。

b.length がゼロならば，書き出しを行わない。そうでなければ，b[0] から順に，b[1]...b[b.length-1] を書き出す。

22.2.3 public void write(byte[] b, int off, int len) throws IOException, NullPointerException, IndexOutOfBoundsException

write は，配列 b の len バイトを出力ストリームに書き出す。

b が null ならば，NullPointerException を投げる。

off 若しくはlen が負のとき，又はoff+len が配列 b の長さより大きいときは，IndexOutOfBoundsException を投げる。

len がゼロならば，書き出しを行わない。そうでなければ，b[off] から順に，b[off+1]...b[off+len-1] を書き出す。

22.2.4 public void writeBoolean(boolean v) throws IOException

writeBoolean は，1バイトを出力ストリームに書き出す。実引数 v が true ならば (byte)1 を， false ならば (byte)0 を書き出す。

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readBoolean (22.1.4)で読み込めば，v と等しい boolean の値を返す。

22.2.5 public void writeByte(int v) throws IOException

writeByte は，実引数の値から1バイトを出力ストリームに書き出す。書き出すバイトは，実引数 b の下位8ビットとする。上位24ビットは，無視する。 (writeByte は，write に一つの整数を実引数として与えたものと同じとする。)

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readByte (22.1.5) で読み込めば，(byte)v と等しい byte の値を返す。

22.2.6 public void writeShort(int v) throws IOException

writeShort は，この実引数の値を表すために2バイトを出力ストリームに書き出す。書き出すバイトを順に次に示す。

(byte)(0xff & (v >> 8))
(byte)(0xff & v)

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readShort (22.1.7)で読み込めば，(short)v と等しい short の値を返す。

22.2.7 public void writeChar(int v) throws IOException

writeChar は，この実引数の値を表すために2バイトを出力ストリームに書き出す。書き出すバイトを順に次に示す。

(byte)(0xff & (v >> 8)
(byte)(0xff & v)

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readChar (22.1.9) で読み込めば，(char)v と等しい char の値を返す。

22.2.8 public void writeInt(int v) throws IOException

writeInt は，この実引数の値を表すために4バイトを出力ストリームに書き出す。書き出すバイトを順に次に示す。

(byte)(0xff & (v >> 24))
(byte)(0xff & (v >> 16))
(byte)(0xff & (v >>    8))
(byte)(0xff & v)

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readInt (22.1.10) で読み込めば，v と等しい int の値を返す。

22.2.9 public void writeLong(long v) throws IOException

writeLongは，この実引数の値を表すために8バイトを出力ストリームに書き出す。書き出すバイトを順に次に示す。

(byte)(0xff & (v >> 56))
(byte)(0xff & (v >> 48))
(byte)(0xff & (v >> 40))
(byte)(0xff & (v >> 32))
(byte)(0xff & (v >> 24))
(byte)(0xff & (v >> 16))
(byte)(0xff & (v >>    8))
(byte)(0xff & v)

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readLong (22.1.11) で読み込めば，v と等しい long の値を返す。

22.2.10 public void writeFloat(float v) throws IOException

writeFloat は，この実引数の値を表すために4バイトを出力ストリームに書き出す。まず，メソッド Float.floatToIntBits (20.9.22) と同じ方法で，float から int に変換する。それから，その int の値をメソッド writeInt (22.2.8) と同じ方法で書き出す。

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readFloat (22.1.12) で読み込めば，v と等しい float の値を返す。

22.2.11 public void writeDouble(double v) throws IOException

writeDouble は，この実引数の値を表すために8バイトを出力ストリームに書き出す。まず，メソッド Double.doubleToLongBits (20.10.21) と同じ方法で，double から long へ変換する。その long の値をメソッド writeLong (22.2.9) と同じ方法で書き出す。

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readDouble (22.1.13) で読み込めば，v と等しい double の値を返す。

22.2.12 public void writeBytes(String s) throws IOException, NullPointerException

writeBytes は，文字列 s のそれぞれの文字をバイトに変換し，その順番に出力ストリームに書き出す。

s が null ならば，NullPointerException を投げる。

s.length がゼロならば，書き出しを行わない。そうでなければ， s[0] から順に，s[1]...s[s.length-1] を書き出す。各文字毎にメソッド writeByte (22.2.5) と同じ方法で，下位の1バイトを書き出す。上位の8ビットは，無視される。

22.2.13 public void writeChars(String s) throws IOException, NullPointerException

writeChars は，文字列 s のそれぞれの文字を2バイトに変換し，その順番に出力ストリームに書き出す。

s が null ならば，NullPointerException を投げる。

s.length がゼロならば，書き出しを行わない。そうでなければ，s[0] から順に，s[1]...s[s.length-1] を書き出す。各文字毎にメソッド writeChar (22.2.7) と同じ方法で，上位バイトを先に2バイトを書き出す。

22.2.14 public void writeUTF(String s) throws IOException, NullPointerException

writeUTF は，文字列 s のそれぞれの文字を，次のJava修正版UTF表現の2バイトに変換し，その順番に出力ストリームに書き出す。

s が null ならば，NullPointerException を投げる。

各文字を，その値によって，1～3バイトのグループに変換する。

文字 c が， "\u0001" 以上 "\u007f" 以下の範囲ならば，次の順で1バイトで表現する。

(byte)c

文字 c が， "\u0000" 若しくは "\u0080" 以上 "\u07ff" 以下の範囲ならば，次の順で2バイトで表現する。


(byte)(0xc0 | (0x1f & (c >> 6)))
(byte)(0x80 | (0x3f & c))

文字 c が， "\u0800" 以上 "\uffff" 以下の範囲ならば，次の順で3バイトで表現する。


(byte)(0xc0 | (0x0f & (c >> 12)))
(byte)(0x80 | (0x3f & (c >>    6)))
(byte)(0x80 | (0x3f & c))

まず，s の文字を表現するの必要なバイト数を計算する。それが 65535 よりも大きい場合は，UTFDataFormatError を投げる。そうでなければ，その長さのバイト数をメソッド writeShort (22.2.6) と同じ方法で書き出す。文字列 s の各文字を，1～3バイトの表現で書き出す。

このメソッドが書き出したバイトを，インタフェース DataInput のメソッド readUTF (22.1.15) で読み込めば，s と等しい String を返す。

22.3 クラス `java.io.InputStream`

入力ストリームは，いくつかのソースからバイトの入力を可能にする。


public abstract class InputStream {
    public abstract int read() throws IOException;
    public int read(byte[] b)
    throws IOException, NullPointerException;
    public int read(byte[] b, int off, int len)
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public long skip(long n) throws IOException;
    public int available() throws IOException;
    public void close() throws IOException;
    public void mark(int readlimit);
    public void reset() throws IOException;
    public boolean markSupported();
}

22.3.1 public abstract int read() throws IOException

read は，入力ストリームから1バイトを読み込む。そのバイトを，0 から 255 の整数(0x00-0xff)として値を返す。ストリームがファイルの終わりに到達すると，-1 を返す。

このメソッドは，データの入力が可能であるか，ファイルの終わりに到達するか，又は例外が投げられるまでブロックする。

ファイルの終り以外の何らかの理由でバイトを読み込めない場合，IOException を投げる。特に，入力ストリームが閉じられている(22.3.6) 場合には，IOException を投げる。

22.3.2 public int read(byte[] b) throws IOException, NullPointerException

read(b) は，数バイトを入力ストリームから読み込み，バッファ配列 b に格納する。正しく読み込んだバイト数を整数値で返す。

このメソッドは，データの入力が可能であるか，ファイルの終わりに到達するか，又は例外が投げられるまでブロックする。

b が null ならば，NullPointerException を投げる。

b の長さがゼロならば，読み込みを実行せずに 0 を返す。そうでなければ，少なくとも1バイトの読込みを試みる。ストリームがファイルの終わりに達していて入力がなければ，-1 を返す。そうでなければ，少なくとも1バイトを読み込み，b に格納する。

最初のバイトを，要素 b[0] に格納する。そして順に b[1]...に格納する。読み込むバイト数は，高々 b の長さとする。実際に読み込むバイト数を k とすると，これらのバイトを，b[0] から b[k-1] に格納する。要素 b[k] から要素 b[b.length-1] には，影響を与えない。

ファイルの終り以外の何らかの理由でバイトを読み込めない場合，IOException を投げる。特に，入力ストリームが閉じられている(22.15.5) 場合には，IOExceptionを投げる。

クラス InputStream の read(b) メソッドは，次の結果と同じとする。

read(b, 0, b.length)

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

read(b, off, len) は，数バイトを入力ストリームから読み込み，配列 b に格納する。 len バイトの読込みを試みるが，それより少ない数(ゼロもある)を読み込むことがある。それから，正しく読み込んだバイト数を整数値で返す。

このメソッドは，データの入力が可能であるか，ファイルの終わりに到達するか，又は例外が投げられるまでブロックする。

b が null ならば，NullPointerException を投げる。

off 若しくはlen が負のとき，又はoff+len が配列 b の長さより大きいときは，IndexOutOfBoundsException を投げる。

len がゼロならば，読み込みを実行せずに0 を返す。そうでなければ，少なくとも1バイトの読込みを試みる。ストリームがファイルの終わりに達していて入力がなければ，-1 を返す。そうでなければ，少なくとも1バイトを読み込み，b に格納する。

最初のバイトを，要素 b[off] に格納する。そして順に b[off+1]...に格納する。読み込むバイト数は，高々 len とする。実際に読み込むバイト数を k とすると，これらのバイトを，b[off] から b[off+k-1] に格納する。要素 b[off+k] から要素 b[b.length-1] には，影響を与えない。

どんな場合でも，要素 b[0] から b[off-1] まで及び要素 b[off+len] から b[b.length-1] には，影響を与えない。

ファイルの終り以外の何らかの理由でバイトを読み込めない場合，IOException を投げる。特に，入力ストリームが閉じられている (22.15.5) 場合には，IOExceptionを投げる。

クラス InputStream のメソッドread(b, off, len) は，単にread() を繰り返して呼ぶ。最初の呼び出しで IOException が投げられると，その例外を，その呼出しからメソッドread(b, off, len) に返す。その後の read() の呼び出しで IOException が投げられたときは，それを捕捉してファイルの終わりとして扱う。それまでに読み込んだバイトを b に格納し，その例外が発生する前までに読み込んだバイト数を返す。

22.3.4 public long skip(long n) throws IOException

skip は，入力ストリームからのデータを n バイト分スキップする。スキップしたバイト列は，捨てる。しかしながら，ゼロを含め，いくつか少ないバイト数をスキップすることがある。これは，いくつかの状態から生じる。 n バイトをスキップする前にファイルの終わりに達することは，そのうちの一つの可能性である。実際にスキップしたバイト数を返す。

22.3.5 public int available() throws IOException

available は，同一スレッド又は別のスレッドで，次の k バイトの読み込み又はスキップの呼び出しが，ブロック(入力データ待ち)せずに実行できるような，整数 k を返す。

クラス InputStream のメソッド available は，常に 0 を返す。

22.3.6 public int close() throws IOException

close は，入力ストリームを閉じる。閉じたストリームは，入力処理及び再び開くことはできない。

クラス InputStream のメソッド close は，何もせずにそのまま戻る。

22.3.7 public void mark(int readlimit)

メソッド markSupported が true を返すときに，ストリームは，何らかの方法によって mark が呼ばれた後に読み込まれたすべてのバイトを記憶しておき，メソッドresetが呼び出された時にはいつでも，それらの同じバイトを再び供給できるものとして準備する。しかしながら，ストリームは，resetが呼び出される前に，readlimitバイトよりも多く読み込まれたすべてのバイトを記憶しておく必要はない。

クラス InputStream のメソッド mark は，何もしない。

22.3.8 public void reset() throws IOException

reset の役割は，次の通りとする。

メソッド markSupported が true を返すならば，

ストリームを生成して以来一度もmark が呼ばれていないとき，又は最後に mark を呼び出してから読み込んだバイト数が，mark の実引数で与えられた値を超えているときは，IOException を投げてもよい。
該当するIOException を投げない場合，直前のmark の呼出しから(一度も markを呼び出していないときは，ファイルの最初から)読み込まれたすべてのバイトが，それ以降のreadメソッドの呼出し時に再度供給できる状態にストリームをリセットする。別の次回の入力データとなるすべてのバイトは， reset を呼び出したときと同じものになる。

メソッド markSupported が false を返すならば，

reset は，IOException を投げてもよい。
IOException を投げないなら，入力ストリームの特定の型及びそれがどのようにして生成されたかによって，決められた状態にストリームをリセットする。後続のreadメソッドの呼出しに供給されるバイトは，入力ストリームの特定の型に依存する。

クラス InputStream のメソッド reset は，常に IOException を投げる。

22.3.9 public boolean markSupported()

markSupported が true を返すならば，そのストリームは， mark (22.3.7) 及び reset (22.3.8) 処理を支援している。すべての InputStream のインスタンスに対して，このメソッドは，呼び出されたときはいつでも，一貫して同じ真偽値を返さなければならない。

クラス InputStream のメソッド markSupported は，false を返す。

22.4 クラス `java.io.FileInputStream`

ファイル入力ストリームは，入力バイトをファイルシステム内のファイルから得る。どんなファイルが有効かは，ホスト環境に依存する。

public class FileInputStream extends InputStream  {
    public FileInputStream(String path)
        throws SecurityException, FileNotFoundException;
    public FileInputStream(File file)
        throws SecurityException, FileNotFoundException;
    public FileInputStream(FileDescriptor fdObj)
        throws SecurityException;
    public native int read() throws IOException;
    public int read(byte[] b)
        throws IOException, NullPointerException;
    public int read(byte[] b, int off, int len)
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public native long skip(long n) throws IOException;
    public native int available() throws IOException;
    public native void close() throws IOException;
    public final FileDescriptor getFD() throws IOException;
    protected void finalize() throws IOException;
}

22.4.1 public FileInputStream(String path) throws SecurityException, FileNotFoundException

このコンストラクタは，新しく生成した FileInputStream を，実際のファイルとの接続を開くことによって初期化する。そのファイルは，ファイルシステム内のパス名によって指定される。このファイル接続を表すために，新しい FileDescriptor オブジェクトを生成する。

まず，セキュリティマネージャが存在するならば，path 実引数をその実引数として，メソッド checkRead (20.17.19) を呼ぶ。

実際のファイルを開くことができなければ，FileNotFoundException を投げる。

22.4.2 public FileInputStream(File file) throws SecurityException, FileNotFoundException

このコンストラクタは，新しく生成した FileInputStream を，実際のファイルとの接続を開くことによって初期化する。そのファイルは，ファイルシステム内の File オブジェクトである file によって指定される。このファイル接続を表すために，新しい FileDescriptor オブジェクトを生成する。

まず，セキュリティマネージャが存在するならば，file 実引数で表したパスをその実引数として，メソッド checkRead (20.17.19) を呼ぶ。

実際のファイルが開くことができなければ，FileNotFoundException を投げる。

22.4.3 public FileInputStream(FileDescriptor fdObj) throws SecurityException

このコンストラクタは，ファイルデスクリプタ fdObj を使って，新しく生成した FileInputStream を初期化する。 fdObje は，ファイルシステム内の実際のファイルとの存在する接続を表す。

まず，セキュリティマネージャが存在するならば，fdObj 実引数をその実引数として，メソッド checkRead (20.17.18) を呼ぶ。

22.4.4 public final FileDescriptor getFD() throws IOException

このメソッドは，この FileInputStream で使用している，ファイルシステム内の実際のファイルとの接続を表す FileDescriptor オブジェクト (22.26) を返す。

22.4.5 public int read() throws IOException

このファイル入力ストリームが接続されている，実際のファイルから1バイトを読み込む。

InputStream のメソッド read (22.3.1) を実装する。

22.4.6 public int read(byte[] b) throws IOException, NullPointerException

このファイル入力ストリームが接続されている，実際のファイルからバイト列を読み込む。

InputStream のメソッド read (22.3.2) を上書きする。

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

このファイル入力ストリームが接続されている，実際のファイルからバイト列を読み込む。

InputStream のメソッド read (22.3.3) を上書きする。

22.4.8 public long skip(long n) throws IOException

このファイル入力ストリームが接続されている，実際のファイルからバイト列を読み込む。

InputStream のメソッド skip (22.3.4) を上書きする。

22.4.9 public int available() throws IOException

InputStream のメソッド available (22.3.5) を上書きする。

22.4.10 public void close() throws IOException

ファイル入力ストリームを閉じ，もはやバイト列の読み出しに使用されなくなる。

InputStream のメソッド close (22.3.6) を上書きする。

22.4.11 protected void finalize() throws IOException

FileInputStream は，実際のファイルとの接続を後始末するために，終了化を使用している。

22.5 クラス `java.io.PipedInputStream`

パイプ入力ストリームは，パイプ出力ストリームと接続しなければならない。したがって，パイプ入力ストリームは，パイプ出力ストリームに書き出されるバイト列ならば何でも提供する。典型的には，一つのスレッドが，PipedInputStream オブジェクトからデータを読み込み，他のあるスレッドが，対応する PipedOutputStream (22.17) へデータを書き出す。両方のオブジェクトを単一のスレッドで使うことは，デッドロックになることがあるので推奨できない。パイプ入力ストリームは，制限内で出力処理から入力処理を切り離しているバッファを含む。

public class PipedInputStream extends InputStream {
    public PipedInputStream(PipedOutputStream src)
        throws IOException;
    public PipedInputStream();
    public void connect(PipedOutputStream src)
        throws IOException;
    public int read() throws IOException;
    public int read(byte[] b, int off, int len) 
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public void close() throws IOException;
}

22.5.1 public PipedInputStream(PipedOutputStream src) throws IOException

このコンストラクタは，新しく生成した PipedInputStream を，パイプ出力ストリームsrc と接続するものとして初期化する。 src に書き出されたデータは，このストリームの入力として利用可能になる。

22.5.2 public PipedInputStream()

このコンストラクタは，新しく生成した PipedInputStream を，まだ接続していないものとして初期化する。使用する前に，PipedOutputStream に接続しなければならない。

22.5.3 public void connect(PipedOutputStream src) throws IOException

メソッド connect は，このパイプ入力ストリームを，パイプ出力ストリームsrc に接続する。このオブジェクトが既に他のパイプ出力ストリームに接続されているならば，IOException を投げる。

src が接続されていないパイプ出力ストリームであり，snk が接続されていないパイプ入力ストリームであるならば，それらは，次のいずれか一方の呼出しによって接続できる。

snk.connect(src)

又は，

src.connect(snk)

この二つの呼出しは，同じ効果をもつ。

22.5.4 public int read() throws IOException

一つのスレッドが，接続したパイプ出力ストリームにデータを供給していたが，既にそのスレッドが活動していない場合，IOException を投げる。

InputStream (22.3.1)のメソッド read を実装する。

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

一つのスレッドが，接続したパイプ出力ストリームにデータを供給していたが，既にそのスレッドが活動していない場合，IOException を投げる。

InputStream のメソッド read (22.3.3)を上書きする。

22.5.6 public void close() throws IOException

このパイプ入力ストリームを閉じ，もはやバイト列の読み出しに使用されなくなる。

InputStream のメソッド close (22.3.6) を上書きする。

22.6 クラス `java.io.ByteArrayInputStream`

ByteArrayInputStream は，ストリームから読み込まれるバイト列を格納する内部バッファをもつ。内部カウンタは，メソッド read が次に読むべきバイトの位置を保持する。 StringBufferInputStream (22.7)を参照のこと。

public class ByteArrayInputStream extends InputStream {
    protected byte[] buf;
    protected int pos;
    protected int count;
    public ByteArrayInputStream(byte[] buf);
    public ByteArrayInputStream(byte[] buf,
            int offset, int length);
    public int read()
        throws NullPointerException, IndexOutOfBoundsException;
    public int read(byte[] b, int off, int len)
        throws NullPointerException, IndexOutOfBoundsException;
    public long skip(long n);
    public int available();
    public void reset();
}

22.6.1 protected byte[] buf;

ストリームのクリエータによって提供されるバイト型配列。要素 buf[0] から buf[count-1] が，そのストリームから読み込むことができるバイトとする。要素 buf[pos] は，次に読むバイトとする。

22.6.2 protected int pos;

この値は，常に非負でありかつ count の値よりも大きくてはならない。このストリームから次に読むバイトは， buf[pos] とする。

22.6.3 protected int count;

この値は，常に非負であり，buf の長さよりも大きくてはならない。これは，このストリームからこれまでに読まれた buf 内の最後のバイトよりも1大きい。

22.6.4 public ByteArrayInputStream(byte[] buf)

このコンストラクタは，新たに生成された ByteArrayInputStream を，buf をそのバッファ配列として使用するために初期化する。 pos の初期値は，0 であり，count の初期値は， buf の長さとする。

22.6.5 public ByteArrayInputStream(byte[] buf, int offset, int length)

このコンストラクタは，新たに生成された ByteArrayInputStreamを，bufをそのバッファ配列として使用するために初期化する。 pos の初期値は，offsetであり，count の初期値は，offset+len とする。

結果として生成された入力ストリームから単純にバイト列を読むのであれば，要素 buf[pos] から buf[pos+len-1] が読み込まれるが，reset 操作(22.6.10)を実行すると，バイト列 buf[0] から buf[pos-1] が入力として利用可能になることに注意のこと。

22.6.6 public int read() throws NullPointerException, IndexOutOfBoundsException

pos が count と等しければ，ファイルの終りを示すために -1 を返す。そうでなければ，値 buf[pos]&0xff を返す。戻る直前に pos を， 1 増加させる。

InputStream のメソッド read (22.3.1)を実装する。

22.6.7 public int read(byte[] b, int off, int len) throws NullPointerException, IndexOutOfBoundsException

pos が count と等しければ，ファイルの終りを示すために -1 を返す。そうでなければ，読み込んだバイト数 k は， len 又は count-pos の小さいほうに等しい。 k が正であれば， buf[pos] から buf[pos+k-1] のバイトを System.arraycopy(20.18.16)と同じ方法で b[off] から b[off+k-1] に複写する。値 k を pos に加算し，k を返す。

InputStream の read(22.3.3)を上書きする。

22.6.8 public long skip(long n)

実際にスキップされるバイト数 k は， n 又は count-pos の小さいほうに等しい。値 k を pos に加算し，k を返す。

InputStream の skip(22.3.4)を上書きする。

22.6.9 public int available()

count-pos の値を返す。

InputStream の available(22.3.5)を上書きする。

22.6.10 public void reset()

pos の値を 0 にする。

InputStream のメソッド reset(22.3.8)を上書きする。

22.7 クラス `java.io.StringBufferInputStream`

StringBufferInputStream は，そのストリームから読み込まれるバイト列を格納する内部バッファをもつ。ある内部カウンタが，メソッド read によって供給される次のバイトの位置を保持する。 ByteArrayInputStream (22.6)を参照のこと。

public class StringBufferInputStream extends InputStream {
    protected String buffer;
    protected int pos;
    protected int count;
    public StringBufferInputStream(String s)
        throws NullPointerException;
    public int read();
    public int read(byte[] b, int off, int len)
        throws NullPointerException, IndexOutOfBoundsException;
    public long skip(long n);
    public int available();
    public void reset();
}

StringBufferInputStream から読み込まれるバイト列は，文字列中の文字一つ一つの下位8ビットであり，上位8ビットは，無視されることに注意のこと。

22.7.1 protected String buffer;

そのストリームのクリエータによって提供されるString とする。要素 buffer[0] から buffer[count-1] がこれまでに読み込むことができたバイトとする。要素 buffer[pos] は，次に読むバイトとする。

22.7.2 protected int pos;

この値は，常に非負でありかつ count の値よりも大きくてはならない。このストリームから次に読み込まれるバイトは， buffer[pos] とする。

22.7.3 protected int count;

この値は， buffer の長さに等しい。それは，このストリームから読み込むことができる buffer 内のデータのバイト数とする。

22.7.4 public StringBufferInputStream(String s) throws NullPointerException

このコンストラクタは，新たに生成された StringBufferInputStream を，s をバッファ配列として使用するために初期化する。 pos の初期値は，0であり，countの初期値は，bufferの長さとする。

22.7.5 public int read()

pos が count と等しければ，ファイルの終りを示すために -1 を返す。そうでなければ，値 buffer[pos]&0xff を返す。戻る直前に pos は， 1 増加させる。

InputStream のメソッド read (22.3.1)を実装する。

22.7.6 public int read(byte[] b, int off, int len) throws NullPointerException, IndexOutOfBoundsException

pos が count と等しければ，ファイルの終りを示すために -1 を返す。そうでなければ，読み込んだバイト数 k は， len 又は count-pos の小さいほうに等しい。 k が正であれば buffer[pos] から b[off+k-1] のバイト列を System.arraycopy(20.18.16)と同じ方法で b[off] から buffer[pos+k-1] に複写する。値 k を pos に加算し，k を返す。

InputStream の read(22.3.3)メソッドを上書きする。

22.7.7 public long skip(long n)

実際にスキップされるバイト数 k は， n 又は count-pos の小さいほうに等しい。値 k に， pos を加算し，k を返す。

InputStream の skip(22.3.4)メソッドを上書きする。

22.7.8 public int available()

count-pos の値を返す。

InputStream の available(22.3.5)メソッドを上書きする。

22.7.9 public void reset()

pos の値を 0 にする。

InputStream のメソッド reset(22.3.8) を上書きする。

22.8 クラス `java.io.SequenceInputStream`

SequenceInputStream は，複数の入力ストリームの論理的な結合を表現する。順序付けられた入力ストリームの集合から始まり，最初のストリームからファイルの終わりに達するまでを読み込む。その次に2番目のストリーム，そしてまたその次と，含まれる入力ストリームの最後のファイルの終わりに達するまで読み込む。

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)

このコンストラクタは，新たに生成された SequenceInputStreamを，その実引数を記憶することによって初期化する。この実引数は，実行時の型が InputStream(22.3)となるオブジェクトを生成するEnumeration(21.1)でなければならない。 Enumeration によって生成される入力ストリームが，このSequenceInputStreamが読み込むバイト列を供給するために，順に読み込まれる。 Enumeration の各入力ストリームに読み込むべきバイトがなくなると，メソッド close を呼び出すことによってクローズする。

22.8.2 public SequenceInputStream(InputStream s1, InputStream s2)

このコンストラクタは，新たに生成された SequenceInputStreamを，二つの実引数を記憶することによって初期化する。これらは，この SequenceInputStream から読み込むバイト列を提供するために，最初に s1 ，次に s2 と順に読み込まれる。

22.8.3 public int read() throws IOException

InputStream の read(22.3.1)を実装する。

22.8.4 public int read(byte[] buf, int pos, int len) throws IOException, NullPointerException, IndexOutOfBoundsException

InputStream の read(22.3.3)を上書きする。

22.8.5 public void close() throws IOException

この SequenceInputStreamをクローズする。クローズされた SequenceInputStream は，入力操作を行うことも再びオープンすることもできない。

このストリームが Enumeration から生成されている場合は，そのEnumerationから要求されいるすべての残りの要素は，メソッド close が戻る前にクローズされる。

InputStream の close(22.3.6)を上書きする。

22.9 クラス `java.io.FilterInputStream`

FilterInputStreamは，基本的なデータの入力源として使用するある別の入力ストリームを含んでおり，そのデータを一定の方法で加工したり，付加的な機能を提供したりする。 FilterInputStream自体は，InputStreamのすべてのメソッドを，すべての要求を自らが保持する入力ストリームに転送するだけのメソッドで，単に上書きしているだけである。 FilterInputStreamのサブクラスは，これらのメソッドのいくつかをさらに上書きしてもよいし，メソッド又はフィールドを追加してもよい。

public class FilterInputStream extends InputStream {
    protected InputStream in;
    protected FilterInputStream(InputStream in);
    public int read() throws IOException;
    public int read(byte[] b)
        throws IOException, NullPointerException;
    public int read(byte[] b, int off, int len)
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public long skip(long n) throws IOException;
    public int available() throws IOException;
    public void close() throws IOException;
    public void mark(int readlimit);
    public void reset() throws IOException;
    public boolean markSupported();
}

22.9.1 protected InputStream in;

フィルタされる入力ストリームとする。

22.9.2 protected FilterInputStream(InputStream in)

このコンストラクタは，新たに生成された FilterInputStreamを実引数 inを後で使用を可能にするために，this.in フィールドに代入することによって初期化する。

22.9.3 public int read() throws IOException

このメソッドは，単に in.read() を実行し，その結果を返す。

InputStream の read(22.3.1)を実装する。

22.9.4 public int read(byte[] b) throws IOException, NullPointerException

このメソッドは，単に呼出し read(b, 0, b.length) を実行し，その結果を返す。 in.read(b)の代わりを実行 するのではない という点が重要である。 FilterInputStream の，あるサブクラスは，実際に使用されている実装の方針に依存する。

InputStream のメソッド read(22.3.2)を上書きする。

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

このメソッドは，単に in.read(b, off, len) を実行し，その結果を返す。

InputStream の read(22.3.3)を上書きする。

22.9.6 public long skip(long n) throws IOException

このメソッドは，単に in.skip() を実行し，その結果を返す。

InputStream の skip(22.3.4)を上書きする。

22.9.7 public int available() throws IOException

このメソッドは，単に in.available() を実行し，その結果を返す。

InputStream の available(22.3.5)を上書きする。

22.9.8 public void close() throws IOException

このメソッドは，単に in.close()を実行し，その結果を返す。

InputStream の close(22.3.6)を上書きする。

22.9.9 public void mark(int readlimit)

このメソッドは，単に in.mark() を実行し，その結果を返す。

InputStreammark(22.3.7)を上書きする。

22.9.10 public void reset() throws IOException

このメソッドは，単に in.reset() を実行し，その結果を返す。

InputStream の reset(22.3.8)を上書きする。

22.9.11 public boolean markSupported()

このメソッドは，単に in.markSupported() を実行し，その結果を返す。

InputStream の markSupported(22.3.9)を上書きする。

22.10 クラス `java.io.BufferedInputStream`

BufferedInputStream は，他の入力ストリームに機能，つまり，入力をバッファリングする能力並びにメソッドmark 及びreset を支援する能力を追加する。 BufferedInputStream が生成されるときに，内部的なバッファ配列が生成される。そのストリームからバイトが読み込み又はスキップされた時，内部的なバッファは，それに含まれる入力ストリームから必要に応じて補充される，一度に多くのバイトが補充される。 mark 操作は，入力ストリームの中の位置を記憶し，reset 操作は，最も最近に実行した mark 操作後に読み込まれたすべてのバイトが，含まれる入力ストリームから新たなバイトが読まれる前に，再度読み込まれるものとする。

public class BufferedInputStream extends FilterInputStream {
    protected byte[] buf;
    protected int count = 0;
    protected int pos = 0;
    protected int markpos = -1;
    protected int marklimit = 0;
    public BufferedInputStream(InputStream in);
    public BufferedInputStream(InputStream in, int size);
    public int read() throws IOException;
    public int read(byte[] b)
        throws IOException, NullPointerException;
    public int read(byte[] b, int off, int len)
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public long skip(long n) throws IOException;
    public int available() throws IOException;
    public void mark(int readlimit);
    public void reset() throws IOException;
    public boolean markSupported();
}

22.10.1 protected byte[] buf;

内部バッファ配列とする。必要に応じてサイズの異なる他の配列によって置き換えられる場合がある。

22.10.2 protected int count = 0;

この値は，常に 0 から buf.length の範囲にある。要素 buf[0] から buf[count-1] が，入力ストリームから読み込んだバッファリングされている入力データを保持している。

22.10.3 protected int pos = 0;

この値は，常に 0 から count の範囲にある。この値が count よりも小さいならば，buf[pos] が入力として供給される次のバイトとする。 count に等しい場合は，次の read 又は skip 操作は，読み込む次のバイトを含まれる入力ストリームから要求する。

22.10.4 protected int markpos = -1;

この値は，常に -1 から pos の範囲にある。入力ストリームにマーク付けされた位置がない場合には，この値は -1 とする。入力ストリームにマーク付けされた位置がある場合には， buf[markpos] が reset 操作後に入力として供給される最初のバイトとする。 markpos が -1 でない場合， buf[markpos] から buf[pos-1] までのすべてのバイトは，バッファ配列の中に保持されていなければならない (count ，pos, 及び markpos の値に対する適切な調整を伴って，バッファ配列中の別の場所に移動している可能性はある)。これらのバイトは，pos 及び markpos の差が marklimitを超えない限り及び超えるまでは，廃棄してはならない。

22.10.5 protected int marklimit;

pos 及び markpos の差が marklimit を超える場合にはいつでも，markpos を -1 に設定してマークを消してもよい。

22.10.6 public BufferedInputStream(InputStream in)

このコンストラクタは，新たに生成された BufferedInputStream を，後の使用に備えて，その実引数である入力ストリーム in を保存することによって初期化する。内部バッファ配列を生成し，buf に格納する。

22.10.7 public BufferedInputStream(InputStream in, int size)

このコンストラクタは，新たに生成された BufferedInputStream を，後の使用に備えて，その実引数である入力ストリーム in を保存するすることによって初期化する。長さ size の内部バッファ配列を生成し，buf に格納する。

22.10.8 public int read() throws IOException

InputStream のメソッド read(22.3.1)を参照のこと。

FilterInputStream のメソッド read(22.9.3)を上書きする。

22.10.9 public int read(byte[] b) throws IOException, NullPointerException

InputStream のメソッド read(22.3.2)を参照のこと。

FilterInputStream のメソッド read(22.9.4)を上書きする。

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

InputStream のメソッド read(22.3.3)を参照のこと。

FilterInputStream のメソッド read(22.9.5)を上書きする。

22.10.11 public long skip(long n) throws IOException

InputStream のメソッド skip(22.3.4)を参照のこと。

FilterInputStream のメソッド skip(22.9.6)を上書きする。

22.10.12 public int available() throws IOException

InputStream のメソッド available(22.3.5)を参照のこと。

FilterInputStream のメソッド available(22.9.7)を上書きする。

22.10.13 public void mark(int readlimit)

フィールド marklimitを実引数の値に設定し， markpos を pos の値に設定する。

FilterInputStream のメソッド mark(22.9.9)を上書きする。

22.10.14 public void reset() throws IOException

InputStream のメソッド reset の一般的な規則(22.3.8)を参照のこと。

markpos が -1 であれば(マークされていない，あるいは，マークが無効になった場合)，IOException を投げる。そうでなければ，pos を markpos と同じ値に設定する。

FilterInputStream のメソッド reset(22.9.10)を上書きする。

22.10.15 public boolean markSupported()

このメソッドは， true を返す ( BufferedInputStream は，常に mark を支援する)。

FilterInputStream の markSupported(22.9.11)メソッドを上書きする。

22.11 クラス `java.io.DataInputStream`

データ入力ストリームは，入力源からバイト列を読み，特定の文字の並びを，さまざまな型のデータを表現するものとして解釈する機能を提供する。

public class DataInputStream extends FilterInputStream
        implements DataInput {
    public DataInputStream(InputStream in);
    public final void readFully(byte[] b)
        throws IOException, NullPointerException;
    public final void readFully(byte[] b, int off, int len)
        throws IOException, NullPointerException,
            IndexOutOfBoundsException;
    public final int skipBytes(int n) throws IOException;
    public final boolean readBoolean() throws IOException;
    public final byte readByte() throws IOException;
    public final int readUnsignedByte() throws IOException;
    public final short readShort() throws IOException;
    public final int readUnsignedShort() throws IOException;
    public final char readChar() throws IOException;
    public final int readInt() throws IOException;
    public final long readLong() throws IOException;
    public final float readFloat() throws IOException;
    public final double readDouble() throws IOException;
    public final String readLine() throws IOException;
    public final String readUTF() throws IOException;
    public final static String readUTF(DataInput in)
        throws IOException;
}

22.11.1 public DataInputStream(InputStream in)

このコンストラクタは，新たに生成したDataInputStream を，後の使用に備えて，その実引数である入力ストリーム in を保存することによって初期化する。

22.11.2 public final void readFully(byte[] b) throws IOException, NullPointerException

DataInput のメソッド readFully の一般的な規則(22.1.1)を参照のこと。