java.lang.Object
java.io.InputStream
java.io.FilterInputStream
java.io.DataInputStream
- すべての実装されたインタフェース:
Closeable,DataInput,AutoCloseable
public class DataInputStream extends FilterInputStream implements DataInput
データ入力ストリームにより、アプリケーションは、プリミティブ型のJavaデータをベースとなる入力ストリームからマシンに依存せずに読み込むことができます。 アプリケーションはデータ出力ストリームを使ってデータを書き込むことにより、そのデータをあとで入力ストリームから読み込むこともできます。
DataInputStreamは、複数の並行スレッドで安全に使用できません。 DataInputStreamを複数のスレッドで使用する場合は、適切な同期によってデータ入力ストリームへのアクセスを制御する必要があります。
- 導入されたバージョン:
- 1.0
- 関連項目:
-
フィールドのサマリー
クラスjava.io.FilterInputStreamで宣言されたフィールド
in -
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明final intread(byte[] b) 格納されている入力ストリームから数バイトを読み込み、それをバッファ配列bに格納します。final intread(byte[] b, int off, int len) 最大lenバイトのデータを、格納されている入力ストリームからバイト配列に読み込みます。final booleanDataInputのreadBooleanメソッドの汎用規約を参照してください。final bytereadByte()DataInputのreadByteメソッドの汎用規約を参照してください。final charreadChar()DataInputのreadCharメソッドの汎用規約を参照してください。final doubleDataInputのreadDoubleメソッドの汎用規約を参照してください。final floatDataInputのreadFloatメソッドの汎用規約を参照してください。final voidreadFully(byte[] b) DataInputのreadFullyメソッドの汎用規約を参照してください。final voidreadFully(byte[] b, int off, int len) DataInputのreadFullyメソッドの汎用規約を参照してください。final intreadInt()DataInputのreadIntメソッドの汎用規約を参照してください。final StringreadLine()非推奨。このメソッドでは、バイトから文字への変換が正しく行われません。final longreadLong()DataInputのreadLongメソッドの汎用規約を参照してください。final shortDataInputのreadShortメソッドの汎用規約を参照してください。final intDataInputのreadUnsignedByteメソッドの汎用規約を参照してください。final intDataInputのreadUnsignedShortメソッドの汎用規約を参照してください。final StringreadUTF()DataInputのreadUTFメソッドの汎用規約を参照してください。static final String修正UTF-8形式でエンコードされたUnicode文字列表現を、ストリームinから読み込みます。読み込まれた文字列は、Stringとして返されます。final intskipBytes(int n) DataInputのskipBytesメソッドの汎用規約を参照してください。クラスjava.io.FilterInputStreamで宣言されたメソッド
available, close, mark, markSupported, read, reset, skipクラスjava.io.InputStreamで宣言されたメソッド
nullInputStream, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo
-
コンストラクタの詳細
-
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- 最初のバイトを読み込めない理由がファイルの終わりに達したからではない場合、ストリームが閉じられており、ベースとなる入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
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- 最初のバイトを読み込めない理由がファイルの終わりに達したからではない場合、ストリームが閉じられており、ベースとなる入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readFully
public final void readFully(byte[] b) throws IOException DataInputのreadFullyメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readFully、インタフェースDataInput- パラメータ:
b- データの読込み先のバッファ。- 例外:
NullPointerException-bがnullである場合。EOFException- すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readFully
public final void readFully(byte[] b, int off, int len) throws IOException DataInputのreadFullyメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readFully、インタフェースDataInput- パラメータ:
b- データの読込み先のバッファ。off- データ配列bの開始オフセット。len- 読み込むバイト数。- 例外:
NullPointerException-bがnullである場合。IndexOutOfBoundsException-offが負の値の場合、lenが負の値の場合、またはlenがb.length - offより大きい場合EOFException- すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
skipBytes
public final int skipBytes(int n) throws IOException DataInputのskipBytesメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
skipBytes、インタフェースDataInput- パラメータ:
n- スキップされるバイト数。- 戻り値:
- 実際にスキップされたバイト数。
- 例外:
IOException- 含まれる入力ストリームがシークをサポートしない場合、ストリームが閉じられており、含まれる入力ストリームが閉じられた状態での読込みをサポートしない場合、またはその他の入出力エラーが発生した場合。
-
readBoolean
public final boolean readBoolean() throws IOExceptionDataInputのreadBooleanメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readBoolean、インタフェースDataInput- 戻り値:
- 読み込まれた
booleanの値。 - 例外:
EOFException- 入力ストリームが終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readByte
public final byte readByte() throws IOExceptionDataInputのreadByteメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readByte、インタフェースDataInput- 戻り値:
- 符号付き8ビット
byteと見なされる入力ストリームの次のバイト。 - 例外:
EOFException- 入力ストリームが終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readUnsignedByte
public final int readUnsignedByte() throws IOExceptionDataInputのreadUnsignedByteメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readUnsignedByte、インタフェースDataInput- 戻り値:
- 入力ストリームの次のバイトを符号なし8ビットと解釈した値。
- 例外:
EOFException- 入力ストリームが終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readShort
public final short readShort() throws IOExceptionDataInputのreadShortメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readShort、インタフェースDataInput- 戻り値:
- 入力ストリームの次の2バイトを符号付き16ビットと解釈した値。
- 例外:
EOFException- 2バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readUnsignedShort
public final int readUnsignedShort() throws IOExceptionDataInputのreadUnsignedShortメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readUnsignedShort、インタフェースDataInput- 戻り値:
- 入力ストリームの次の2バイトを符号なし16ビットと解釈した整数値。
- 例外:
EOFException- 2バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readChar
public final char readChar() throws IOExceptionDataInputのreadCharメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readChar、インタフェースDataInput- 戻り値:
- 入力ストリームの次の2バイトを
charと解釈した値。 - 例外:
EOFException- 2バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readInt
public final int readInt() throws IOExceptionDataInputのreadIntメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readInt、インタフェースDataInput- 戻り値:
- ストリームの次の4バイトを
intと解釈した値。 - 例外:
EOFException- 4バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readLong
public final long readLong() throws IOExceptionDataInputのreadLongメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readLong、インタフェースDataInput- 戻り値:
longとして解釈される、この入力ストリームの次の8バイト。- 例外:
EOFException- 8バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readFloat
public final float readFloat() throws IOExceptionDataInputのreadFloatメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readFloat、インタフェースDataInput- 戻り値:
floatとして解釈される、この入力ストリームの次の4バイト。- 例外:
EOFException- 4バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
readDouble
public final double readDouble() throws IOExceptionDataInputのreadDoubleメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readDouble、インタフェースDataInput- 戻り値:
doubleとして解釈される、この入力ストリームの次の8バイト。- 例外:
EOFException- 8バイトを読み終わる前に入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。- 関連項目:
-
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- 入出力エラーが発生した場合。- 関連項目:
-
readUTF
public final String readUTF() throws IOExceptionDataInputのreadUTFメソッドの汎用規約を参照してください。このオペレーションのバイトは、格納されている入力ストリームから読み込まれます。
- 定義:
readUTF、インタフェースDataInput- 戻り値:
- Unicode文字列。
- 例外:
EOFException- すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。IOException- ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。UTFDataFormatException- 文字列中のバイトが、有効な修正UTF-8形式でエンコードされた文字列以外であった場合。- 関連項目:
-
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文字列以外であった場合。- 関連項目:
-