java.io
クラス DataInputStream

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

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

DataInput

public class DataInputStream
extends FilterInputStream
implements DataInput

DataInputStream は入力ストリームから基本データ型のデータを機器非依存に読み込む入力ストリームです。

コンストラクタの概要

DataInputStream(InputStream is)
指定された入力ストリームを内部の入力ストリームとする DataInputStream を生成します。

メソッドの概要

boolean	readBoolean() 1バイトを読み込み、値に基づいた boolean 値を返します。
byte	readByte() 1バイトを byte として読み込んで返します。
char	readChar() 2バイトを char として上位バイトから読み込んで返します。
void	readFully(byte[] b) b.length バイトを読み込み、b に格納します。
void	readFully(byte[] b, int off, int len) len バイトを読み込み、配列 b のインデックスオフセット off から格納します。
int	readInt() 4バイトを int として上位バイトから読み込んで返します。
String	readLine() テキスト行を一つ読み込んで返します。
long	readLong() 8バイトを long として上位バイトから読み込んで返します。
short	readShort() 2バイトを short として上位バイトから読み込んで返します。
int	readUnsignedByte() 1バイトを符号無し整数として読み込み、 int の最下位バイトに格納して返します。
int	readUnsignedShort() 2バイトを符号無し整数として上位バイトから読み込み、 int の下位16ビットに格納して返します。
String	readUTF() Modified UTF-8 文字列を読み込みます。
static String	readUTF(DataInput in) 指定された入力ストリームから Modified UTF-8 文字列を読み込みます。
int	skipBytes(int n) 入力ストリームから n バイトをスキップします。

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

available, close, mark, markSupported, read, read, read, reset, skip

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

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait

コンストラクタの詳細

DataInputStream

public DataInputStream(InputStream is)

指定された入力ストリームを内部の入力ストリームとする DataInputStream を生成します。

パラメータ:

is - DataInputStream に付属させる入力ストリーム

メソッドの詳細

readLong

public final long readLong()
                    throws IOException

8バイトを long として上位バイトから読み込んで返します。

定義:

インタフェース DataInput 内の readLong

戻り値:

読み込んだ long 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readInt

public final int readInt()
                  throws IOException

4バイトを int として上位バイトから読み込んで返します。

定義:

インタフェース DataInput 内の readInt

戻り値:

読み込んだ int 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readShort

public final short readShort()
                      throws IOException

2バイトを short として上位バイトから読み込んで返します。

定義:

インタフェース DataInput 内の readShort

戻り値:

読み込んだ short 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readUnsignedShort

public final int readUnsignedShort()
                            throws IOException

2バイトを符号無し整数として上位バイトから読み込み、 int の下位16ビットに格納して返します。

定義:

インタフェース DataInput 内の readUnsignedShort

戻り値:

読み込んだ符号無し16ビット値を表す int 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readChar

public final char readChar()
                    throws IOException

2バイトを char として上位バイトから読み込んで返します。

定義:

インタフェース DataInput 内の readChar

戻り値:

読み込んだ char 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readByte

public final byte readByte()
                    throws IOException

1バイトを byte として読み込んで返します。

定義:

インタフェース DataInput 内の readByte

戻り値:

読み込んだ byte 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readUnsignedByte

public final int readUnsignedByte()
                           throws IOException

1バイトを符号無し整数として読み込み、 int の最下位バイトに格納して返します。

定義:

インタフェース DataInput 内の readUnsignedByte

戻り値:

読み込んだ符号無し8ビット値を表す int 値

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readBoolean

public final boolean readBoolean()
                          throws IOException

1バイトを読み込み、値に基づいた boolean 値を返します。

定義:

インタフェース DataInput 内の readBoolean

戻り値:

読み込んだバイトが非零の場合 true 、零の場合 false

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readFully

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

b.length バイトを読み込み、b に格納します。

定義:

インタフェース DataInput 内の readFully

パラメータ:

b - このメソッドが読み込んだバイトデータを格納する byte 配列

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readFully

public final void readFully(byte[] b,
                            int off,
                            int len)
                     throws IOException

len バイトを読み込み、配列 b のインデックスオフセット off から格納します。

定義:

インタフェース DataInput 内の readFully

パラメータ:

b - このメソッドが読み込んだバイトデータを格納する配列

off - 読み込んだバイトデータを格納する先の配列のオフセットインデックス

len - 読み込むバイトデータの最大長

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

readUTF

public final String readUTF()
                     throws IOException

Modified UTF-8 文字列を読み込みます。 先ず、2バイト符号無し整数を、後続する文字列を表すバイト列のバイト長として読み込みます。 そして続くバイト列を Modified UTF-8 でエンコードされた文字列として読み込み String に格納して返します。

定義:

インタフェース DataInput 内の readUTF

戻り値:

読み込んだ Modified UTF-8 文字列を表す String

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

UTFDataFormatException - 読み込んだバイト列が不正な Modified UTF-8 文字列である場合

readUTF

public static final String readUTF(DataInput in)
                            throws IOException

指定された入力ストリームから Modified UTF-8 文字列を読み込みます。 in.readUTF() を実行します。

戻り値:

読み込んだ Modified UTF-8 文字列を表す String

例外:

IOException - I/Oエラーが発生した場合

EOFException - 読み込み終わる前にストリームの終端に到達した場合

UTFDataFormatException - 読み込んだバイト列が不正な Modified UTF-8 文字列である場合

readLine

public final String readLine()
                      throws IOException

テキスト行を一つ読み込んで返します。

このメソッドは読み込んだバイト列の個々のバイトを個々の文字コードとみなして文字列に変換します。したがってこのメソッドはユニコード文字セットをサポートしていません。

テキスト行の区切りは 復帰（ '\r' )、改行（ '\n' )、復帰に続く改行（ '\r\n' )、またはストリームの終端によって識別されます。 復帰や改行はテキスト行の一部とはみなされず、戻り値の String には含まれません。

このメソッドで読み込むデータの中に '\r' があると、'\r' の出現以後、コンストラクタに渡した InputStream が mark をサポートするかどうかに関わらず、このクラスに対する mark と reset はサポートされなくなります。 そして、FilterInputStream.markSupported() は false を返すようになります。 この制限は、JavaSE6 と同じです。

戻り値:

読み込んだ行を表す String 。 ストリームが既に終端に達していた場合は null 。

例外:

IOException - I/Oエラーが発生した場合

skipBytes

public final int skipBytes(int n)
                    throws IOException

入力ストリームから n バイトをスキップします。

定義:

インタフェース DataInput 内の skipBytes

パラメータ:

n - スキップするバイト数。 このパラメータに0以下を指定した場合の振る舞いは保証されません。

戻り値:

実際にスキップしたバイト数。 n より小さな値であることもあります。

例外:

IOException - I/Oエラーが発生した場合

関連項目:

InputStream.skip(long)