DataInputStream (Java Platform SE 7)

java.lang.Object
- java.io.InputStream
- - java.io.FilterInputStream
  - - java.io.DataInputStream

すべての実装されたインタフェース:

Closeable, DataInput, AutoCloseable
```
public class DataInputStream
extends FilterInputStream
implements DataInput
```
データ入力ストリームにより、アプリケーションは、プリミティブ型の Java データをベースとなる入力ストリームからマシンに依存せずに読み込むことができます。アプリケーションはデータ出力ストリームを使ってデータを書き込むことにより、そのデータをあとで入力ストリームから読み込むこともできます。
DataInputStream は、マルチスレッドアクセスに対して必ずしも安全ではありません。スレッドの安全性はこのクラスのメソッドを使用するユーザーによってオプションで保証されます。

導入されたバージョン:

JDK1.0

関連項目:
DataOutputStream

フィールドのサマリー
- クラス java.io.FilterInputStream から継承されたフィールド
  in

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

DataInputStream(InputStream in)
指定されたベースとなる InputStream を使用する DataInputStream を作成します。

コンストラクタ
コンストラクタと説明
`DataInputStream(InputStream in)` 指定されたベースとなる InputStream を使用する DataInputStream を作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`int`	`read(byte[] b)` 格納されている入力ストリームから数バイトを読み込み、それをバッファー配列 `b` に格納します。
`int`	`read(byte[] b, int off, int len)` 最大 `len` バイトのデータを、格納されている入力ストリームからバイト配列に読み込みます。
`boolean`	`readBoolean()` `DataInput` の `readBoolean` メソッドの汎用規約を参照してください。
`byte`	`readByte()` `DataInput` の `readByte` メソッドの汎用規約を参照してください。
`char`	`readChar()` `DataInput` の `readChar` メソッドの汎用規約を参照してください。
`double`	`readDouble()` `DataInput` の `readDouble` メソッドの汎用規約を参照してください。
`float`	`readFloat()` `DataInput` の `readFloat` メソッドの汎用規約を参照してください。
`void`	`readFully(byte[] b)` `DataInput` の `readFully` メソッドの汎用規約を参照してください。
`void`	`readFully(byte[] b, int off, int len)` `DataInput` の `readFully` メソッドの汎用規約を参照してください。
`int`	`readInt()` `DataInput` の `readInt` メソッドの汎用規約を参照してください。
`String`	`readLine()` 非推奨。このメソッドでは、バイトから文字への変換が正しく行われません。JDK 1.1 以降、テキスト行を読み込むには、`BufferedReader.readLine()` メソッドを使うことが推奨されています。行を読み込むのに `DataInputStream` クラスを使うプログラムを、`BufferedReader` クラスを使うように変換するには、次の形式のコードを、 DataInputStream d = new DataInputStream(in); 次の形式のコードで置き換えます。 BufferedReader d = new BufferedReader(new InputStreamReader(in));
`long`	`readLong()` `DataInput` の `readLong` メソッドの汎用規約を参照してください。
`short`	`readShort()` `DataInput` の `readShort` メソッドの汎用規約を参照してください。
`int`	`readUnsignedByte()` `DataInput` の `readUnsignedByte` メソッドの汎用規約を参照してください。
`int`	`readUnsignedShort()` `DataInput` の `readUnsignedShort` メソッドの汎用規約を参照してください。
`String`	`readUTF()` `DataInput` の `readUTF` メソッドの汎用規約を参照してください。
`static String`	`readUTF(DataInput in)` 修正 UTF-8 形式でエンコードされた Unicode 文字列表現を、ストリーム `in` から読み込みます。読み込まれた文字列は、`String` として返されます。
`int`	`skipBytes(int n)` `DataInput` の `skipBytes` メソッドの汎用規約を参照してください。

クラス java.io.FilterInputStream から継承されたメソッド
available, close, mark, markSupported, read, reset, skip

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - DataInputStream
```
public DataInputStream(InputStream in)
```
    指定されたベースとなる InputStream を使用する DataInputStream を作成します。
    
    パラメータ:
    in - 指定された入力ストリーム
- メソッドの詳細
  - read
```
public final int read(byte[] b)
               throws IOException
```
    格納されている入力ストリームから数バイトを読み込み、それをバッファー配列 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] は影響を受けません。
    read(b) メソッドの効果は、次と同じです。
    read(b, 0, b.length)
    オーバーライド:
    
    read、クラス: FilterInputStream
    
    パラメータ:
    b - データの読み込み先のバッファー。
    
    戻り値:
    バッファーに読み込まれたバイトの合計数。ストリームの終わりに達してデータがない場合は -1。
    
    例外:
    
    IOException - 最初のバイトを読み込めない理由がファイルの終わりに達したからではない場合、ストリームが閉じられており、ベースとなる入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in, InputStream.read(byte[], int, int)
  - read
```
public final int read(byte[] b,
       int off,
       int len)
               throws IOException
```
    最大 len バイトのデータを、格納されている入力ストリームからバイト配列に読み込みます。len までのバイトの読み込みが試行されますが、読み込まれるバイト数はもっと少ない場合もあり、0 の場合もあります。実際に読み込まれたバイト数は整数として返されます。
    このメソッドは、入力データが読み込めるようになるか、ファイルの終わりが検出されるか、あるいは例外がスローされるまでブロックします。
    len がゼロの場合、バイトは読み込まれず、0 が返されます。それ以外の場合は、少なくとも 1 バイトを読み込もうとします。ストリームがファイルの終わりに達したために読み込むバイトがない場合は値 -1 が返されます。それ以外の場合は、少なくとも 1 バイトが読み込まれ、b に格納されます。
    最初に読み込まれたバイトは要素 b[off] に格納され、次のバイトは b[off+1] に格納され、それ以降も同様に続きます。読み込まれるバイト数の上限は len と同じです。実際に読み込まれるバイト数を k とすると、これらのバイトは要素 b[off] - b[off+k-1] に格納され、要素 b[off+k] - b[off+len-1] は影響を受けません。
    すべての場合に、要素 b[0] - b[off] および要素 b[off+len] - b[b.length-1] は影響を受けません。
    
    オーバーライド:
    
    read、クラス: FilterInputStream
    
    パラメータ:
    b - データの読み込み先のバッファー。
    off - 転送先配列 b の開始オフセット
    len - 読み込まれる最大バイト数。
    
    戻り値:
    バッファーに読み込まれたバイトの合計数。ストリームの終わりに達してデータがない場合は -1。
    
    例外:
    
    NullPointerException - b が null である場合。
    
    IndexOutOfBoundsException - off が負の値の場合、len が負の値の場合、あるいは len が b.length - off より大きい場合
    
    IOException - 最初のバイトを読み込めない理由がファイルの終わりに達したからではない場合、ストリームが閉じられており、ベースとなる入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in, InputStream.read(byte[], int, int)
  - readFully
```
public final void readFully(byte[] b)
                     throws IOException
```
    DataInput の readFully メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readFully、インタフェース: DataInput
    
    パラメータ:
    b - データの読み込み先のバッファー。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readFully
```
public final void readFully(byte[] b,
             int off,
             int len)
                     throws IOException
```
    DataInput の readFully メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readFully、インタフェース: DataInput
    
    パラメータ:
    b - データの読み込み先のバッファー。
    off - データの開始オフセット。
    len - 読み込むバイト数。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - skipBytes
```
public final int skipBytes(int n)
                    throws IOException
```
    DataInput の skipBytes メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    skipBytes、インタフェース: DataInput
    
    パラメータ:
    n - スキップされるバイト数。
    
    戻り値:
    実際にスキップされたバイト数。
    
    例外:
    
    IOException - 含まれる入力ストリームがシークをサポートしない場合、ストリームが閉じられており、含まれる入力ストリームが閉じられた状態での読み込みをサポートしない場合、またはその他の入出力エラーが発生した場合。
  - readBoolean
```
public final boolean readBoolean()
                          throws IOException
```
    DataInput の readBoolean メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readBoolean、インタフェース: DataInput
    
    戻り値:
    読み込まれた boolean の値。
    
    例外:
    
    EOFException - 入力ストリームが終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readByte
```
public final byte readByte()
                    throws IOException
```
    DataInput の readByte メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readByte、インタフェース: DataInput
    
    戻り値:
    符号付き 8 ビット byte と見なされる入力ストリームの次のバイト。
    
    例外:
    
    EOFException - 入力ストリームが終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readUnsignedByte
```
public final int readUnsignedByte()
                           throws IOException
```
    DataInput の readUnsignedByte メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readUnsignedByte、インタフェース: DataInput
    
    戻り値:
    入力ストリームの次のバイトを符号なし 8 ビットと解釈した値。
    
    例外:
    
    EOFException - 入力ストリームが終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readShort
```
public final short readShort()
                      throws IOException
```
    DataInput の readShort メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readShort、インタフェース: DataInput
    
    戻り値:
    入力ストリームの次の 2 バイトを符号付き 16 ビットと解釈した値。
    
    例外:
    
    EOFException - 2 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readUnsignedShort
```
public final int readUnsignedShort()
                            throws IOException
```
    DataInput の readUnsignedShort メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readUnsignedShort、インタフェース: DataInput
    
    戻り値:
    入力ストリームの次の 2 バイトを符号なし 16 ビットと解釈した整数値。
    
    例外:
    
    EOFException - 2 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readChar
```
public final char readChar()
                    throws IOException
```
    DataInput の readChar メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readChar、インタフェース: DataInput
    
    戻り値:
    入力ストリームの次の 2 バイトを char と解釈した値。
    
    例外:
    
    EOFException - 2 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readInt
```
public final int readInt()
                  throws IOException
```
    DataInput の readInt メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readInt、インタフェース: DataInput
    
    戻り値:
    ストリームの次の 4 バイトを int と解釈した値。
    
    例外:
    
    EOFException - 4 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readLong
```
public final long readLong()
                    throws IOException
```
    DataInput の readLong メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readLong、インタフェース: DataInput
    
    戻り値:
    long として解釈される、この入力ストリームの次の 8 バイト。
    
    例外:
    
    EOFException - 8 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    FilterInputStream.in
  - readFloat
```
public final float readFloat()
                      throws IOException
```
    DataInput の readFloat メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readFloat、インタフェース: DataInput
    
    戻り値:
    float として解釈される、この入力ストリームの次の 4 バイト。
    
    例外:
    
    EOFException - 4 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    readInt(), Float.intBitsToFloat(int)
  - readDouble
```
public final double readDouble()
                        throws IOException
```
    DataInput の readDouble メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readDouble、インタフェース: DataInput
    
    戻り値:
    double として解釈される、この入力ストリームの次の 8 バイト。
    
    例外:
    
    EOFException - 8 バイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    関連項目:
    readLong(), Double.longBitsToDouble(long)
  - readLine
```
@Deprecated
public final String readLine()
                      throws IOException
```
    非推奨。このメソッドでは、バイトから文字への変換が正しく行われません。JDK 1.1 以降、テキスト行を読み込むには、BufferedReader.readLine() メソッドを使うことが推奨されています。行を読み込むのに DataInputStream クラスを使うプログラムを、BufferedReader クラスを使うように変換するには、次の形式のコードを、
    DataInputStream d = new DataInputStream(in);
    次の形式のコードで置き換えます。
    BufferedReader d = new BufferedReader(new InputStreamReader(in));
    DataInput の readLine メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readLine、インタフェース: DataInput
    
    戻り値:
    入力ストリームからの次のテキスト行。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    関連項目:
    BufferedReader.readLine(), FilterInputStream.in
  - readUTF
```
public final String readUTF()
                     throws IOException
```
    DataInput の readUTF メソッドの汎用規約を参照してください。
    このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
    
    定義:
    
    readUTF、インタフェース: DataInput
    
    戻り値:
    Unicode 文字列。
    
    例外:
    
    EOFException - すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    
    UTFDataFormatException - 文字列中のバイトが、有効な修正 UTF-8 形式でエンコードされた文字列以外であった場合。
    関連項目:
    readUTF(java.io.DataInput)
  - readUTF
```
public static final String readUTF(DataInput in)
                            throws IOException
```
    修正 UTF-8 形式でエンコードされた Unicode 文字列表現を、ストリーム in から読み込みます。読み込まれた文字列は、String として返されます。修正 UTF-8 表現の詳細は、DataInput の readUTF メソッドのものと完全に一致します。
    
    パラメータ:
    in - データ入力ストリーム。
    
    戻り値:
    Unicode 文字列。
    
    例外:
    
    EOFException - すべてのバイトを読み終わる前に入力ストリームの終わりに達した場合。
    
    IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読み込みをサポートしない場合、または別の入出力エラーが発生した場合。
    
    UTFDataFormatException - 文字列中のバイトが、有効な修正 UTF-8 形式でエンコードされた Unicode 文字列以外であった場合。
    関連項目:
    readUnsignedShort()

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス DataInputStream

フィールドのサマリー

クラス java.io.FilterInputStream から継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス java.io.FilterInputStream から継承されたメソッド

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

コンストラクタの詳細

DataInputStream

メソッドの詳細

read

read

readFully

readFully

skipBytes

readBoolean

readByte

readUnsignedByte

readShort

readUnsignedShort

readChar

readInt

readLong

readFloat

readDouble

readLine

readUTF

readUTF