モジュール java.base
パッケージ java.io

クラスRandomAccessFile

java.lang.Object
java.io.RandomAccessFile
すべての実装されたインタフェース:
Closeable, DataInput, DataOutput, AutoCloseable
public class RandomAccessFile extends Object implements DataOutput, DataInput, Closeable
このクラスのインスタンスは、ランダム・アクセス・ファイルに対する読取りと書込みの両方をサポートします。 ランダム・アクセス・ファイルの動作は、ファイル・システムに格納された大規模なバイト配列の動作に似ています。 また、ファイル・ポインタと呼ばれるある種のカーソル、つまり暗黙の配列へのインデックスがあり、入力操作ではファイル・ポインタの位置でバイトの読取りを開始し、読み取ったバイトを越えてファイル・ポインタを進めます。 ランダム・アクセス・ファイルが読取り/書込みモードで生成された場合、出力操作も利用可能になります。出力操作では、ファイル・ポインタの位置でバイトの書込みを開始し、書き込まれたバイトを越えてファイル・ポインタを進めます。 現在の暗黙の配列の終わりを越えて書き込む出力操作では、配列の拡張が発生します。 ファイル・ポインタはgetFilePointerメソッドにより読み取ることができ、seekメソッドにより設定できます。

必要なバイト数を読み取る前にend-of-fileに到達した場合、IOExceptionの一種であるEOFExceptionがスローされますが、このことはこのクラスのすべての読取りルーチンに当てはまります。 end-of-file以外のなんらかの理由によりバイトを読み取ることができない場合、EOFException以外のIOExceptionがスローされます。 特に、ストリームが閉じられた場合は、IOExceptionがスローされる可能性があります。

導入されたバージョン:
1.0

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

    コンストラクタ
    コンストラクタ
    説明
    RandomAccessFile(File file, String mode)
    File引数で指定されたファイルからの読み込み、およびオプションで書込みを行うためのランダム・アクセス・ファイル・ストリームを作成します。
    RandomAccessFile(String name, String mode)
    指定された名前のファイルからの読み込み、およびオプションで書込みを行うためのランダム・アクセス・ファイル・ストリームを作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    close()
    このランダム・アクセス・ファイル・ストリームを閉じて、ストリームに関連付けられているシステム・リソースを解放します。
    final FileChannel
    getChannel()
    このファイルに関連付けられた一意のFileChannelオブジェクトを返します。
    final FileDescriptor
    getFD()
    このストリームに関連する不透明なファイル記述子を返します。
    long
    getFilePointer()
    このファイルの現在のオフセットを返します。
    long
    length()
    このファイルの長さを返します。
    int
    read()
    このファイルからデータのバイトを読み取ります。
    int
    read(byte[] b)
    最大b.lengthバイトのデータを、このファイルからバイト配列に読み込みます。
    int
    read(byte[] b, int off, int len)
    最大lenバイトのデータを、このファイルからバイト配列に読み込みます。
    final boolean
    readBoolean()
    このファイルからbooleanを読み込みます。
    final byte
    readByte()
    このファイルから署名付き8ビット値を読み取ります。
    final char
    readChar()
    このファイルから文字を読み取ります。
    final double
    readDouble()
    このファイルからdoubleを読み込みます。
    final float
    readFloat()
    このファイルからfloatを読み込みます。
    final void
    readFully(byte[] b)
    現在のファイル・ポインタ位置から始まるb.lengthバイトをこのファイルからバイト配列に読み込みます。
    final void
    readFully(byte[] b, int off, int len)
    現在のファイル・ポインタ位置から始まるlenバイトを正確にこのファイルからバイト配列に読み込みます。
    final int
    readInt()
    このファイルから署名付き32ビット整数文字を読み取ります。
    final String
    readLine()
    このファイルのテキストの次の行を読み取ります。
    final long
    readLong()
    このファイルから署名付き64ビット整数文字を読み取ります。
    final short
    readShort()
    このファイルから署名付き16ビット数を読み取ります。
    final int
    readUnsignedByte()
    このファイルから符号なし8ビット数を読み取ります。
    final int
    readUnsignedShort()
    このファイルから符号なし16ビット数を読み取ります。
    final String
    readUTF()
    このファイルから文字列を読み取ります。
    void
    seek(long pos)
    次の読み取りまたは書込みが発生する、ファイルの先頭から測定したファイル・ポインタ・オフセットを設定します。
    void
    setLength(long newLength)
    このファイルの長さを設定します。
    int
    skipBytes(int n)
    nバイトの入力をスキップして、スキップしたバイトを破棄しようとします。
    void
    write(byte[] b)
    指定されたバイト配列からこのファイルに、現在のファイル・ポインタ位置から始まるb.lengthバイトを書き込みます。
    void
    write(byte[] b, int off, int len)
    指定されたバイト配列のオフセット位置offから始まるlenバイトをこのファイルに書き込みます。
    void
    write(int b)
    このファイルに指定されたバイトを書き込みます。
    final void
    writeBoolean(boolean v)
    booleanを1バイト値としてこのファイルに書き込みます。
    final void
    writeByte(int v)
    byteを1バイト値としてこのファイルに書き込みます。
    final void
    writeBytes(String s)
    文字列をバイトのシーケンスとしてファイルに書き込みます。
    final void
    writeChar(int v)
    charを2バイト値として上位バイトから先にファイルに書き込みます。
    final void
    writeChars(String s)
    文字列を文字のシーケンスとしてファイルに書き込みます。
    final void
    writeDouble(double v)
    DoubleクラスのdoubleToLongBitsメソッドを使ってdouble型の引数をlong型に変換してから、そのlong値を8バイト値として上位バイトから先にファイルに書き込みます。
    final void
    writeFloat(float v)
    FloatクラスのfloatToIntBitsメソッドを使ってfloat型の引数をint型に変換してから、そのint値を4バイト値として上位バイトから先にファイルに書き込みます。
    final void
    writeInt(int v)
    intを4バイト値として上位バイトから先にファイルに書き込みます。
    final void
    writeLong(long v)
    longを8バイト値として上位バイトから先にファイルに書き込みます。
    final void
    writeShort(int v)
    shortを2バイト値として上位バイトから先にファイルに書き込みます。
    final void
    writeUTF(String str)
    修正UTF-8エンコーディングを使って、マシンに依存しない方法で文字列をファイルに書き込みます。

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

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

  • コンストラクタの詳細

    • RandomAccessFile

      public RandomAccessFile(String name, String mode) throws FileNotFoundException
      指定された名前のファイルからの読み込み、およびオプションで書込みを行うためのランダム・アクセス・ファイル・ストリームを作成します。 ファイルへの接続を表すFileDescriptorオブジェクトが新しく作成されます。

      mode引数には、ファイルを開くときのアクセス・モードを指定します。 指定できる値とそれらの意味は、RandomAccessFile(File,String)コンストラクタの指定と同じです。

      セキュリティ・マネージャが存在する場合は、ファイルの読取りアクセスが許可されるかどうかを確認するために、nameを引数としてcheckReadメソッドが呼び出されます。 また、書込みを許可するモードの場合は、ファイルへの書込みアクセスが許可されているかどうかを確認するために、nameを引数としてセキュリティ・マネージャのcheckWriteメソッドが呼び出されます。

      パラメータ:
      name - システムに依存するファイル名
      mode - アクセス・モード
      例外:
      IllegalArgumentException - mode引数が「r」、「rw」、「rws」、または「rwd」でない場合
      FileNotFoundException - モードが"r"であるが、指定された文字列が既存の通常ファイルを示さない場合、モードが"rw"で始まるが、指定された文字列が既存の書込み可能な通常ファイルを示さず、その名前の通常ファイルを新しく作成できない場合、あるいはファイルのオープンまたは作成中にその他のエラーが発生した場合
      SecurityException - セキュリティ・マネージャが存在し、そのcheckReadメソッドがファイルへの読み取りアクセスを拒否した場合、またはそのモードが"rw"であり、セキュリティ・マネージャのcheckWriteメソッドがファイルへの書き込みアクセスを拒否した場合
      関連項目:

    • RandomAccessFile

      public RandomAccessFile(File file, String mode) throws FileNotFoundException
      File引数で指定されたファイルからの読み込み、およびオプションで書込みを行うためのランダム・アクセス・ファイル・ストリームを作成します。 このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。

      mode引数には、ファイルを開くときのアクセス・モードを指定します。 指定できる値とその意味を次に示します。

      アクセス・モードで許可される値と意味
      値意味
      "r" 読取り専用で開きます。 開いたオブジェクトの任意のwriteメソッドを呼び出すと、IOExceptionがスローされます。
      "rw" 読み取りおよび書込み用に開きます。 ファイルが存在しない場合は、その作成が試みられます。
      "rws" "rw"と同様に、読み込みおよび書込み用に開きます。ファイルの内容またはメタデータを更新したときは、ベースとなる記憶装置にも同時に書き込む必要があります。
      "rwd" "rw"と同様に、読み込みおよび書込み用に開きます。ファイルの内容を更新したときは、ベースとなる記憶装置にも同時に適用する必要があります。
      "rws"モードおよび"rwd"モードは、引数としてtrueおよびfalseをそれぞれ渡して、FileChannelクラスのforce(boolean)メソッドのように動作しますが、すべての入出力操作に適用され、多くの場合、より効果的であることが異なります。 ファイルがローカル記憶装置にある場合は、このクラスのメソッドを呼び出したときに、この呼出しによってファイルに適用された変更が、その記憶装置にも常に書き込まれます。 この方法により、システムがクラッシュしたとき、重要な情報を損失から保護できます。 一方、ファイルがローカルの記憶装置上にない場合、書込みは行われません。

      "rwd"モードは、実行される入出力処理の数を減らすために使用できます。 "rwd"を使用した場合は、ファイルの内容への更新だけが記憶装置に書き込まれます。"rws"を使用した場合は、ファイルの内容とメタデータの両方への更新を書き込む必要があります。これには、通常下位レベルの入出力処理が1回以上多く必要となります。

      セキュリティ・マネージャが存在する場合は、ファイルの読取りアクセスが許可されるかどうかを確認するために、fileをパス名の引数としてcheckReadメソッドが呼び出されます。 また、書込みを許可するモードの場合は、ファイルへの書込みアクセスが許可されているかどうかを確認するために、パスを引数としてセキュリティ・マネージャのcheckWriteメソッドが呼び出されます。

      パラメータ:
      file - ファイル・オブジェクト
      mode - アクセス・モード。前述の説明を参照
      例外:
      IllegalArgumentException - mode引数が「r」、「rw」、「rws」、または「rwd」でない場合
      FileNotFoundException - モードが"r"であるが、指定されたファイル・オブジェクトが既存の通常ファイルを示さない場合、モードが"rw"で始まるが、指定されたファイル・オブジェクトが既存の書込み可能な通常ファイルを示さず、その名前の通常ファイルを新しく作成できない場合、あるいはファイルのオープンまたは作成中にその他のエラーが発生した場合
      SecurityException - セキュリティ・マネージャが存在し、そのcheckReadメソッドがファイルへの読み取りアクセスを拒否した場合、またはそのモードが"rw"であり、セキュリティ・マネージャのcheckWriteメソッドがファイルへの書き込みアクセスを拒否した場合
      関連項目:

  • メソッドの詳細

    • getFD

      public final FileDescriptor getFD() throws IOException
      このストリームに関連する不透明なファイル記述子を返します。
      戻り値:
      このストリームに関連するファイル記述子オブジェクト。
      例外:
      IOException - 入出力エラーが発生した場合。
      関連項目:

    • getChannel

      public final FileChannel getChannel()
      このファイルに関連付けられた一意のFileChannelオブジェクトを返します。

      返されるチャネルのpositionは常に、getFilePointerメソッドによって返されるこのオブジェクトのファイル・ポインタ・オフセットと等しくなります。 このオブジェクトのファイル・ポインタ・オフセットを明示的にまたはバイトの読書きによって変更すると、チャネルの位置も変更されます。その逆の場合も同様です。 このオブジェクトを通じてファイルの長さを変更すると、ファイル・チャネルを通じて見える長さも変更されます。その逆の場合も同様です。

      戻り値:
      このファイルと関連付けられているファイル・チャネル
      導入されたバージョン:
      1.4

    • read

      public int read() throws IOException
      このファイルからデータのバイトを読み取ります。 バイトは、0 - 255 (0x00-0x0ff)の範囲の整数として返されます。 入力がまだ利用できない場合、このメソッドはブロックされます。

      RandomAccessFileはInputStreamのサブクラスではありませんが、このメソッドはInputStreamのInputStream.read()メソッドとまったく同様に動作します。

      戻り値:
      データの次のバイト。ファイルの終わりに達した場合は-1。
      例外:
      IOException - 入出力エラーが発生した場合。 end-of-fileに到達した場合はスローされない。

    • read

      public int read(byte[] b, int off, int len) throws IOException
      最大lenバイトのデータを、このファイルからバイト配列に読み込みます。 このメソッドは、少なくとも1バイトの入力を利用できるまでブロックされます。

      RandomAccessFileはInputStreamのサブクラスではありませんが、このメソッドはInputStreamのInputStream.read(byte[], int, int)メソッドとまったく同様に動作します。

      パラメータ:
      b - データの読込み先のバッファ。
      off - データが書き込まれる配列bの開始オフセット。
      len - 読み込まれる最大バイト数。
      戻り値:
      バッファに読み込まれたバイトの合計数。ファイルの終わりに達してデータがない場合は-1。
      例外:
      IOException - ファイルの終わりに達していること以外の理由で最初のバイトを読み込めない場合、ランダム・アクセス・ファイルが閉じられた場合、またはその他の入出力エラーが発生した場合。
      NullPointerException - bがnullである場合。
      IndexOutOfBoundsException - offが負の値の場合、lenが負の値の場合、あるいはlenがb.length - offより大きい場合

    • read

      public int read(byte[] b) throws IOException
      最大b.lengthバイトのデータを、このファイルからバイト配列に読み込みます。 このメソッドは、少なくとも1バイトの入力を利用できるまでブロックされます。

      RandomAccessFileはInputStreamのサブクラスではありませんが、このメソッドはInputStreamのInputStream.read(byte[])メソッドとまったく同様に動作します。

      パラメータ:
      b - データの読込み先のバッファ。
      戻り値:
      バッファに読み込まれたバイトの合計数。このファイルの終わりに達してデータがない場合は-1。
      例外:
      IOException - ファイルの終わりに達していること以外の理由で最初のバイトを読み込めない場合、ランダム・アクセス・ファイルが閉じられた場合、またはその他の入出力エラーが発生した場合。
      NullPointerException - bがnullである場合。

    • readFully

      public final void readFully(byte[] b) throws IOException
      現在のファイル・ポインタ位置から始まるb.lengthバイトをこのファイルからバイト配列に読み込みます。 このメソッドは、要求されたバイト数が読み取られるまでファイルから繰返し読み取ります。 このメソッドは、要求されたバイト数が読み取られるまで、ストリームの終わりが検出されるまで、または例外がスローされるまでブロックされます。
      定義:
      readFully、インタフェースDataInput
      パラメータ:
      b - データの読込み先のバッファ。
      例外:
      NullPointerException - bがnullである場合。
      EOFException - すべてのバイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readFully

      public final void readFully(byte[] b, int off, int len) throws IOException
      現在のファイル・ポインタ位置から始まるlenバイトを正確にこのファイルからバイト配列に読み込みます。 このメソッドは、要求されたバイト数が読み取られるまでファイルから繰返し読み取ります。 このメソッドは、要求されたバイト数が読み取られるまで、ストリームの終わりが検出されるまで、または例外がスローされるまでブロックされます。
      定義:
      readFully、インタフェースDataInput
      パラメータ:
      b - データの読込み先のバッファ。
      off - データ配列bへの開始オフセット。
      len - 読み込むバイト数。
      例外:
      NullPointerException - bがnullである場合。
      IndexOutOfBoundsException - offが負の値の場合、lenが負の値の場合、またはlenがb.length - offより大きい場合
      EOFException - すべてのバイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • skipBytes

      public int skipBytes(int n) throws IOException
      nバイトの入力をスキップして、スキップしたバイトを破棄しようとします。

      このメソッドは、一部の少数のバイト(0バイトも可能)をスキップできます。 このスキップは複数の条件に起因する可能性がありますが、考えられる唯一の場合は、nバイトがスキップされる前にファイルの終わりに達した場合です。 このメソッドは、EOFExceptionをスローすることはありません。 スキップされた実際のバイト数が返されます。 nが負の場合、バイトはスキップされません。

      定義:
      skipBytes、インタフェースDataInput
      パラメータ:
      n - スキップされるバイト数。
      戻り値:
      実際にスキップされたバイト数。
      例外:
      IOException - 入出力エラーが発生した場合。

    • write

      public void write(int b) throws IOException
      このファイルに指定されたバイトを書き込みます。 書込みは、現在のファイル・ポインタの位置で始まります。
      定義:
      write、インタフェースDataOutput
      パラメータ:
      b - 書き込まれるbyte。
      例外:
      IOException - 入出力エラーが発生した場合。

    • write

      public void write(byte[] b) throws IOException
      指定されたバイト配列からこのファイルに、現在のファイル・ポインタ位置から始まるb.lengthバイトを書き込みます。
      定義:
      write、インタフェースDataOutput
      パラメータ:
      b - データ。
      例外:
      IOException - 入出力エラーが発生した場合。

    • write

      public void write(byte[] b, int off, int len) throws IOException
      指定されたバイト配列のオフセット位置offから始まるlenバイトをこのファイルに書き込みます。
      定義:
      write、インタフェースDataOutput
      パラメータ:
      b - データ。
      off - データの開始オフセット。
      len - 書き込むバイト数。
      例外:
      IOException - 入出力エラーが発生した場合。

    • getFilePointer

      public long getFilePointer() throws IOException
      このファイルの現在のオフセットを返します。
      戻り値:
      ファイルの先頭からのバイト単位のオフセットで、ここから次の読み込みまたは書込みが発生する。
      例外:
      IOException - 入出力エラーが発生した場合。

    • seek

      public void seek(long pos) throws IOException
      次の読み取りまたは書込みが発生する、ファイルの先頭から測定したファイル・ポインタ・オフセットを設定します。 オフセットは、ファイルの終わりを越えて設定できます。 ファイルの終わりを越えてオフセットを設定してもファイル長は変わりません。 ファイル長は、ファイルの終わりを越えてオフセットが設定されたあとに書き込まれた場合だけ変わります。
      パラメータ:
      pos - ファイルの先頭を始点とした、バイト単位のオフセット位置。この位置にファイル・ポインタが設定される。
      例外:
      IOException - posが0より小さい場合、あるいは入出力エラーが発生した場合。

    • length

      public long length() throws IOException
      このファイルの長さを返します。
      戻り値:
      バイト単位の、このファイルの長さ。
      例外:
      IOException - 入出力エラーが発生した場合。

    • setLength

      public void setLength(long newLength) throws IOException
      このファイルの長さを設定します。

      lengthメソッドにより返されたファイルの現在の長さが、newLength引数よりも大きい場合、ファイルは切り詰められます。 この場合、getFilePointerメソッドにより返されたファイル・オフセットがnewLengthよりも大きい場合、このメソッドが返したあとのオフセットはnewLengthと同じになります。

      lengthにより返されたファイルの現在の長さがnewLength引数よりも小さい場合、ファイルは拡張されます。 この場合、ファイルの拡張部分の内容は定義されていません。

      パラメータ:
      newLength - ファイルの必要な長さ
      例外:
      IOException - 入出力エラーが発生した場合
      導入されたバージョン:
      1.2

    • close

      public void close() throws IOException
      このランダム・アクセス・ファイル・ストリームを閉じて、ストリームに関連付けられているシステム・リソースを解放します。 閉じられたランダム・アクセス・ファイルでは入出力操作を実行できません。

      このファイルに関連付けられているチャネルがある場合は、そのチャネルも閉じます。

      定義:
      close、インタフェースAutoCloseable
      定義:
      close、インタフェースCloseable
      例外:
      IOException - 入出力エラーが発生した場合。

    • readBoolean

      public final boolean readBoolean() throws IOException
      このファイルからbooleanを読み込みます。 このメソッドは、現在のファイル・ポインタから開始して、単一バイトをファイルから読み取ります。 値0はfalseを表します。 ほかの値はすべてtrueを表します。 このメソッドは、バイトを読込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
      定義:
      readBoolean、インタフェースDataInput
      戻り値:
      読み込まれたbooleanの値。
      例外:
      EOFException - このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readByte

      public final byte readByte() throws IOException
      このファイルから署名付き8ビット値を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、ファイルからバイトを読み取ります。 読み取られたバイトがbであり、0 <= b <= 255の場合、結果は次のとおりです。 
           (byte)(b)

      このメソッドは、バイトを読込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readByte、インタフェースDataInput
      戻り値:
      符号付き8ビットbyteとして解釈される、このファイルの次のバイト。
      例外:
      EOFException - このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readUnsignedByte

      public final int readUnsignedByte() throws IOException
      このファイルから符号なし8ビット数を読み取ります。 このメソッドは、現在のファイル・ポインタから開始してこのファイルからバイトを読み取り、そのバイトを返します。

      このメソッドは、バイトを読込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readUnsignedByte、インタフェースDataInput
      戻り値:
      符号なしの8ビット数として解釈される、このファイルの次のバイト。
      例外:
      EOFException - このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readShort

      public final short readShort() throws IOException
      このファイルから署名付き16ビット数を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、ファイルから2バイトを読み取ります。 読み取られた2バイトが順にb1とb2であり、2つの値がそれぞれ0以上255以下の場合、結果は次のとおりです。 
           (short)((b1 << 8) | b2)

      このメソッドは、2バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readShort、インタフェースDataInput
      戻り値:
      符号付き16ビット数として解釈される、このファイルの次の2バイト。
      例外:
      EOFException - 2バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readUnsignedShort

      public final int readUnsignedShort() throws IOException
      このファイルから符号なし16ビット数を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、ファイルから2バイトを読み取ります。 読み取られた2バイトが順にb1とb2であり、0 <= b1, b2 <= 255の場合、結果は次のとおりです。 
           (b1 << 8) | b2

      このメソッドは、2バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readUnsignedShort、インタフェースDataInput
      戻り値:
      符号なし16ビット整数として解釈される、このファイルの次の2バイト。
      例外:
      EOFException - 2バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readChar

      public final char readChar() throws IOException
      このファイルから文字を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、ファイルから2バイトを読み取ります。 読み取られた2バイトが順にb1とb2であり、0 <= b1, b2 <= 255の場合、結果は次のとおりです。 
           (char)((b1 << 8) | b2)

      このメソッドは、2バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readChar、インタフェースDataInput
      戻り値:
      charとして解釈される、このファイルの次の2バイト。
      例外:
      EOFException - 2バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readInt

      public final int readInt() throws IOException
      このファイルから署名付き32ビット整数文字を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、ファイルから4バイトを読み取ります。 読み取られた2バイトが順にb1、b2、b3、およびb4であり、0 <= b1, b2, b3, b4 <= 255の場合、結果は次のとおりです。 
           (b1 << 24) | (b2 << 16) + (b3 << 8) + b4

      このメソッドは、4バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readInt、インタフェースDataInput
      戻り値:
      intとして解釈される、このファイルの次の4バイト。
      例外:
      EOFException - 4バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readLong

      public final long readLong() throws IOException
      このファイルから署名付き64ビット整数文字を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、ファイルから8バイトを読み取ります。 読み取られたバイトが順にb1、b2、b3、b4、b5、b6、b7、およびb8,で、次の条件を満たす場合: 
           0 <= b1, b2, b3, b4, b5, b6, b7, b8 <=255,

      結果は以下と同じになります。 

           ((long)b1 << 56) + ((long)b2 << 48)
     + ((long)b3 << 40) + ((long)b4 << 32)
     + ((long)b5 << 24) + ((long)b6 << 16)
     + ((long)b7 << 8) + b8

      このメソッドは、8バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readLong、インタフェースDataInput
      戻り値:
      longとして解釈される、このファイルの次の8バイト。
      例外:
      EOFException - 8バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。

    • readFloat

      public final float readFloat() throws IOException
      このファイルからfloatを読み込みます。 このメソッドは、現在のファイル・ポインタから開始して、readIntメソッドを使った場合のようにファイルからint値を読み取り、読み取ったintをFloatクラスのintBitsToFloatメソッドを使ってfloatにします。

      このメソッドは、4バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readFloat、インタフェースDataInput
      戻り値:
      floatとして解釈される、このファイルの次の4バイト。
      例外:
      EOFException - 4バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。
      関連項目:

    • readDouble

      public final double readDouble() throws IOException
      このファイルからdoubleを読み込みます。 このメソッドは、現在のファイル・ポインタから開始して、readLongメソッドを使った場合のようにファイルからlong値を読み取り、読み取ったlongをDoubleクラスのlongBitsToDoubleメソッドを使ってdoubleにします。

      このメソッドは、8バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readDouble、インタフェースDataInput
      戻り値:
      doubleとして解釈される、このファイルの次の8バイト。
      例外:
      EOFException - 8バイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。
      関連項目:

    • readLine

      public final String readLine() throws IOException
      このファイルのテキストの次の行を読み取ります。 このメソッドは、現在のファイル・ポインタから開始して、改行またはファイルの終わりに達するまでファイルからバイトを連続的に読み取ります。 各バイトは、文字の下位8ビットのバイト値を取得し、文字の上位8ビットを0に設定して文字に変換されます。 したがって、このメソッドはUnicode文字セット全体をサポートしていません。

      テキスト行は、キャリッジ・リターン文字('\r')、改行文字('\n')、キャリッジ・リターン文字とそれに続く改行文字、またはファイルの終わりで終了します。 行末文字は破棄され、返された文字列の部分に含まれません。

      このメソッドは、改行文字が読み込まれるまで、復帰とそれに続くバイトが読み込まれる(改行かどうかを確認する)まで、ファイルの終わりに達するまで、または例外がスローされるまでブロックします。

      定義:
      readLine、インタフェースDataInput
      戻り値:
      このファイルからの次のテキスト行。ファイルの終わりが検出されるまでに1バイトも読み込めなかった場合はnull。
      例外:
      IOException - 入出力エラーが発生した場合。

    • readUTF

      public final String readUTF() throws IOException
      このファイルから文字列を読み取ります。 文字列は、修正UTF-8形式を使用してエンコードされています。

      現在のファイル・ポインタから開始して、readUnsignedShortを使用した場合のように最初の2バイトを読み取ります。 この値は、結果として得られる文字列の長さではなく、エンコードされた文字列にある後続のバイト数を提供します。 後続のバイトは、修正UTF-8形式のバイト・エンコーディング文字として解釈され、文字に変換されます。

      このメソッドは、すべてのバイトを読込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。

      定義:
      readUTF、インタフェースDataInput
      戻り値:
      Unicode文字列。
      例外:
      EOFException - すべてのバイトを読み込む前に、このファイルの終わりに達した場合。
      IOException - 入出力エラーが発生した場合。
      UTFDataFormatException - バイトが有効な修正UTF-8エンコーディングのUnicode文字列を表さない場合。
      関連項目:

    • writeBoolean

      public final void writeBoolean(boolean v) throws IOException
      booleanを1バイト値としてこのファイルに書き込みます。 値trueは値(byte)1として書き込まれ、値falseは値(byte)0として書き込まれます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeBoolean、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるboolean値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeByte

      public final void writeByte(int v) throws IOException
      byteを1バイト値としてこのファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeByte、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるbyte値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeShort

      public final void writeShort(int v) throws IOException
      shortを2バイト値として上位バイトから先にファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeShort、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるshort値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeChar

      public final void writeChar(int v) throws IOException
      charを2バイト値として上位バイトから先にファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeChar、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるchar値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeInt

      public final void writeInt(int v) throws IOException
      intを4バイト値として上位バイトから先にファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeInt、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるint値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeLong

      public final void writeLong(long v) throws IOException
      longを8バイト値として上位バイトから先にファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeLong、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるlong値。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeFloat

      public final void writeFloat(float v) throws IOException
      FloatクラスのfloatToIntBitsメソッドを使ってfloat型の引数をint型に変換してから、そのint値を4バイト値として上位バイトから先にファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeFloat、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるfloat値。
      例外:
      IOException - 入出力エラーが発生した場合。
      関連項目:

    • writeDouble

      public final void writeDouble(double v) throws IOException
      DoubleクラスのdoubleToLongBitsメソッドを使ってdouble型の引数をlong型に変換してから、そのlong値を8バイト値として上位バイトから先にファイルに書き込みます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeDouble、インタフェースDataOutput
      パラメータ:
      v - 書き込まれるdouble値。
      例外:
      IOException - 入出力エラーが発生した場合。
      関連項目:

    • writeBytes

      public final void writeBytes(String s) throws IOException
      文字列をバイトのシーケンスとしてファイルに書き込みます。 文字列の各文字は、高位の8ビットを破棄して順に書き込まれます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeBytes、インタフェースDataOutput
      パラメータ:
      s - 書き込まれるバイトの文字列。
      例外:
      IOException - 入出力エラーが発生した場合。

    • writeChars

      public final void writeChars(String s) throws IOException
      文字列を文字のシーケンスとしてファイルに書き込みます。 各文字は、writeCharメソッドを使用した場合のように、データ出力ストリームに書き込まれます。 書込みは、ファイル・ポインタの現在の位置で始まります。
      定義:
      writeChars、インタフェースDataOutput
      パラメータ:
      s - 書き込まれるString値。
      例外:
      IOException - 入出力エラーが発生した場合。
      関連項目:

    • writeUTF

      public final void writeUTF(String str) throws IOException
      修正UTF-8エンコーディングを使って、マシンに依存しない方法で文字列をファイルに書き込みます。

      まず、現在のファイル・ポインタから開始して、後続のバイト数を指定するwriteShortメソッドを使った場合のように、2バイトがファイルに書き込まれます。 この値は、実際に書き込まれるバイト数であり、文字列の長さではありません。 長さに続いて、各文字に修正UTF-8エンコーディングを使って、文字列の各文字が順に出力されます。

      定義:
      writeUTF、インタフェースDataOutput
      パラメータ:
      str - 書き込まれる文字列。
      例外:
      IOException - 入出力エラーが発生した場合。