java.io.DataInputStream

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

public class DataInputStream
extends FilterInputStream
implements DataInput

データ入力ストリームにより、アプリケーションは、プリミティブ型のJavaデータをベースとなる入力ストリームからマシンに依存せずに読み込むことができます。アプリケーションはデータ出力ストリームを使ってデータを書き込むことにより、そのデータをあとで入力ストリームから読み込むこともできます。

DataInputStreamは、マルチスレッド・アクセスに対して必ずしも安全ではありません。スレッドの安全性はこのクラスのメソッドを使用するユーザーによってオプションで保証されます。

導入されたバージョン:: 1.0
関連項目:: DataOutputStream

フィールドのサマリー

クラス java.io.FilterInputStreamで宣言されたフィールド
in
コンストラクタのサマリー

コンストラクタ

コンストラクタ説明

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()`	非推奨。このメソッドでは、バイトから文字への変換が正しく行われません。
`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.io.InputStreamで宣言されたメソッド

nullInputStream, readAllBytes, readNBytes, readNBytes, skipNBytes, transferTo

クラス 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 - データの読込み先のバッファ。
  
  例外:
  
  NullPointerException - bがnullである場合。
  
  EOFException - すべてのバイトを読み込む前に、この入力ストリームの終わりに達した場合。
  
  IOException - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。
  
  関連項目:
  
  FilterInputStream.in
- 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 - ストリームが閉じられており、格納されている入力ストリームが閉じられた状態での読込みをサポートしない場合、または別の入出力エラーが発生した場合。
  
  関連項目:
  
  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()

クラスDataInputStream

フィールドのサマリー

クラス java.io.FilterInputStreamで宣言されたフィールド

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

メソッドのサマリー

クラス java.io.FilterInputStreamで宣言されたメソッド

クラス java.io.InputStreamで宣言されたメソッド

クラス java.lang.Objectで宣言されたメソッド

コンストラクタの詳細

メソッドの詳細