javax.jnlp
インタフェース JNLPRandomAccessFile

すべてのスーパーインタフェース:
java.io.DataInput, java.io.DataOutput

public interface JNLPRandomAccessFile
extends java.io.DataInput, java.io.DataOutput

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

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

実装には、ファイルに書き込み可能なデータの最大量を施行することが勧められています。

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

メソッドの概要
 void close()
          このランダムアクセスファイルストリームを閉じて、ストリームに関連付けられたシステムリソースを解放します。
 long getFilePointer()
          このファイルの現在のオフセットを返します。
 long length()
          このファイルの長さを返します。
 int read()
          このファイルからデータのバイトを読み取ります。
 int read(byte[] b)
          このファイルから最大 b.length バイトのデータをバイトの配列の中に読み取ります。
 int read(byte[] b, int off, int len)
          このファイルから最大 len バイトのデータをバイトの配列の中に読み取ります。
 boolean readBoolean()
          このファイルから boolean を読み取ります。
 byte readByte()
          このファイルから署名付き 8 ビット値を読み取ります。
 char readChar()
          このファイルから Unicode 文字を読み取ります。
 double readDouble()
          このファイルから double を読み取ります。
 float readFloat()
          このファイルから float を読み取ります。
 void readFully(byte[] b)
          現在のファイルポインタの位置から開始して b.length バイトをこのファイルからバイト配列の中に読み取ります。
 void readFully(byte[] b, int off, int len)
          現在のファイルポインタの位置から開始して正確に len バイトをこのファイルからバイト配列の中に読み取ります。
 int readInt()
          このファイルから署名付き 32 ビット整数文字を読み取ります。
 java.lang.String readLine()
          このファイルのテキストの次の行を読み取ります。
 long readLong()
          このファイルから署名付き 64 ビット整数文字を読み取ります。
 short readShort()
          このファイルから署名付き 16 ビット数を読み取ります。
 int readUnsignedByte()
          このファイルから符号なし 8 ビット数を読み取ります。
 int readUnsignedShort()
          このファイルから符号なし 16 ビット数を読み取ります。
 java.lang.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)
          このファイルに指定されたバイトを書き込みます。
 void writeBoolean(boolean v)
          1 バイト値として boolean をファイルに書き込みます。
 void writeByte(int v)
          byte を 1 バイト値としてこのファイルに書き込みます。
 void writeBytes(java.lang.String s)
          文字列をバイトのシーケンスとしてファイルに書き込みます。
 void writeChar(int v)
          char を 2 バイト値として、高位バイトを先にファイルに書き込みます。
 void writeChars(java.lang.String s)
          文字列を文字のシーケンスとしてファイルに書き込みます。
 void writeDouble(double v)
          Double クラスの doubleToLongBits メソッドを使って、double 引数を long に変換します。
 void writeFloat(float v)
          Float クラスの floatToIntBits メソッドを使って、float 引数を int に変換します。
 void writeInt(int v)
          int を 4 バイトとして、高位バイトを先にファイルに書き込みます。
 void writeLong(long v)
          long を 8 バイトとして、高位バイトを先にファイルに書き込みます。
 void writeShort(int v)
          short を 2 バイト値として、高位バイトを先にファイルに書き込みます。
 void writeUTF(java.lang.String str)
          UTF-8 エンコーディングを使って、マシンに依存するやり方で文字列をファイルに書き込みます。
 

メソッドの詳細

close

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

例外:
java.io.IOException - I/O エラーが発生した場合

length

long length()
            throws java.io.IOException
このファイルの長さを返します。

戻り値:
このファイルの長さ (バイト単位で測定)
例外:
java.io.IOException - I/O エラーが発生した場合

getFilePointer

long getFilePointer()
                    throws java.io.IOException
このファイルの現在のオフセットを返します。

戻り値:
次の読み取りまたは書き込みが発生する位置のファイルの先頭からのオフセット (バイト単位)
例外:
java.io.IOException - I/O エラーが発生した場合

read

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

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

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

read

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

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

パラメータ:
b - データが読み取られるバッファ
off - データの開始オフセット
len - 読み取られたバイトの最大数
戻り値:
バッファの中に読み取られたバイトの合計数、ファイルの終わりに達したためにデータがない場合は -1
例外:
java.io.IOException - I/O エラーが発生した場合

read

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

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

パラメータ:
b - データが読み取られるバッファ
戻り値:
バッファの中に読み取られたバイトの合計数、このファイルの終わりに達したためにデータがない場合は -1
例外:
java.io.IOException - I/O エラーが発生した場合

readFully

void readFully(byte[] b)
               throws java.io.IOException
現在のファイルポインタの位置から開始して b.length バイトをこのファイルからバイト配列の中に読み取ります。このメソッドは、要求されたバイト数が読み取られるまでファイルから繰り返し読み取ります。このメソッドは、要求されたバイト数が読み取られるまで、ストリームの終わりが検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readFully
パラメータ:
b - データが読み取られるバッファ
例外:
EOFException - すべてのバイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readFully

void readFully(byte[] b,
               int off,
               int len)
               throws java.io.IOException
現在のファイルポインタの位置から開始して正確に len バイトをこのファイルからバイト配列の中に読み取ります。このメソッドは、要求されたバイト数が読み取られるまでファイルから繰り返し読み取ります。このメソッドは、要求されたバイト数が読み取られるまで、ストリームの終わりが検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readFully
パラメータ:
b - データが読み取られるバッファ
off - データの開始オフセット
len - 読み取るバイト数
例外:
EOFException - すべてのバイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

skipBytes

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

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

定義:
インタフェース java.io.DataInput 内の skipBytes
パラメータ:
n - スキップされるバイト数
戻り値:
スキップされた実際のバイト数
例外:
java.io.IOException - I/O エラーが発生した場合

readBoolean

boolean readBoolean()
                    throws java.io.IOException
このファイルから boolean を読み取ります。このメソッドは、現在のファイルポインタから開始して、単一バイトをファイルから読み取ります。0 の値は false を表します。ほかの値は true を表します。このメソッドは、バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readBoolean
戻り値:
読み取られた boolean
例外:
EOFException - このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readByte

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

このメソッドは、バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readByte
戻り値:
署名付き 8 ビット byte として解釈されるこのファイルの次のバイト
例外:
EOFException - このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readUnsignedByte

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

このメソッドは、バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

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

readShort

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

このメソッドは、2 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readShort
戻り値:
署名付き 16 ビット数として解釈されるこのファイルの次の 2 バイト
例外:
EOFException - 2 バイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readUnsignedShort

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

このメソッドは、2 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

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

readChar

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

このメソッドは、2 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readChar
戻り値:
Unicode 文字として解釈されるこのファイルの次の 2 バイト
例外:
EOFException - 2 バイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readInt

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

このメソッドは、4 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readInt
戻り値:
int として解釈されるこのファイルの次の 4 バイト
例外:
EOFException - 4 バイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readLong

long readLong()
              throws java.io.IOException
このファイルから署名付き 64 ビット整数文字を読み取ります。このメソッドは、現在のファイルポインタから開始して、ファイルから 8 バイトを読み取ります。読み取られたバイトが順に b1b2b3b4b5b6b7、および 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 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readLong
戻り値:
long として解釈されるこのファイルの次の 8 バイト
例外:
EOFException - 8 バイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合

readFloat

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

このメソッドは、4 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readFloat
戻り値:
float として解釈されるこのファイルの次の 4 バイト
例外:
EOFException - 4 バイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合
関連項目:
readInt()

readDouble

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

このメソッドは、8 バイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readDouble
戻り値:
double として解釈されるこのファイルの次の 8 バイト
例外:
EOFException - 8 バイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合
関連項目:
readLong()

readLine

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

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

このメソッドは、改行文字が読み取られるまで、キャリッジリターンとそれに続くバイトが読み取られるまで (改行かどうかを判定するため)、ファイルの終わりに達するまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readLine
戻り値:
このファイルのテキストの次の行、1 バイトが読み取られる前であってもファイルの終わりが検出された場合は null
例外:
java.io.IOException - I/O エラーが発生した場合

readUTF

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

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

このメソッドは、すべてのバイトが読み取られるまで、ストリームの最後が検出されるまで、または例外がスローされるまでブロックされます。

定義:
インタフェース java.io.DataInput 内の readUTF
戻り値:
Unicode 文字列
例外:
EOFException - すべてのバイトを読み取る前に、このファイルの終わりに到達した場合
java.io.IOException - I/O エラーが発生した場合
UTFDataFormatException - バイトが Unicode 文字列の有効な UTF-8 エンコーディングを表さない場合
関連項目:
readUnsignedShort()

seek

void seek(long pos)
          throws java.io.IOException
次の読み取りまたは書き込みが発生する、ファイルの先頭から測定したファイルポインタオフセットを設定します。オフセットは、ファイルの終わりを越えて設定できます。ファイルの終わりを越えてオフセットを設定してもファイル長は変わりません。ファイル長は、ファイルの終わりを越えてオフセットが設定されたあとに書き込まれた場合だけ変わります。

パラメータ:
pos - ファイルの先頭から測定された、ファイルポインタが設定されるオフセット位置 (バイト単位)
例外:
java.io.IOException - pos0 未満の場合、または I/O エラーが発生した場合

setLength

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

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

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

パラメータ:
newLength - ファイルの必要な長さ
例外:
java.io.IOException - I/O エラーが発生した場合

write

void write(int b)
           throws java.io.IOException
このファイルに指定されたバイトを書き込みます。書き込みは、現在のファイルポインタの位置で始まります。

定義:
インタフェース java.io.DataOutput 内の write
パラメータ:
b - 書き込まれる byte
例外:
java.io.IOException - I/O エラーが発生した場合

write

void write(byte[] b)
           throws java.io.IOException
現在のファイルポインタの位置から開始して、指定されたバイト配列から b.length バイトをこのファイルに書き込みます。

定義:
インタフェース java.io.DataOutput 内の write
パラメータ:
b - データ
例外:
java.io.IOException - I/O エラーが発生した場合

write

void write(byte[] b,
           int off,
           int len)
           throws java.io.IOException
オフセット off の位置から開始して、指定されたバイト配列から len バイトをこのファイルに書き込みます。

定義:
インタフェース java.io.DataOutput 内の write
パラメータ:
b - データ
off - データの開始オフセット
len - 書き込むバイト数
例外:
java.io.IOException - I/O エラーが発生した場合

writeBoolean

void writeBoolean(boolean v)
                  throws java.io.IOException
1 バイト値として boolean をファイルに書き込みます。値 true は、値 (byte)1 として書き込まれ、値 false は値 (byte)0 として書き込まれます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeBoolean
パラメータ:
v - 書き込まれる boolean
例外:
java.io.IOException - I/O エラーが発生した場合

writeByte

void writeByte(int v)
               throws java.io.IOException
byte を 1 バイト値としてこのファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeByte
パラメータ:
v - 書き込まれる byte
例外:
java.io.IOException - I/O エラーが発生した場合

writeShort

void writeShort(int v)
                throws java.io.IOException
short を 2 バイト値として、高位バイトを先にファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeShort
パラメータ:
v - 書き込まれる short
例外:
java.io.IOException - I/O エラーが発生した場合

writeChar

void writeChar(int v)
               throws java.io.IOException
char を 2 バイト値として、高位バイトを先にファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeChar
パラメータ:
v - 書き込まれる char
例外:
java.io.IOException - I/O エラーが発生した場合

writeInt

void writeInt(int v)
              throws java.io.IOException
int を 4 バイトとして、高位バイトを先にファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeInt
パラメータ:
v - 書き込まれる int
例外:
java.io.IOException - I/O エラーが発生した場合

writeLong

void writeLong(long v)
               throws java.io.IOException
long を 8 バイトとして、高位バイトを先にファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeLong
パラメータ:
v - 書き込まれる long
例外:
java.io.IOException - I/O エラーが発生した場合

writeFloat

void writeFloat(float v)
                throws java.io.IOException
Float クラスの floatToIntBits メソッドを使って、float 引数を int に変換します。次に、変換された int 値を 4 バイトの量として、高位バイトを先にファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeFloat
パラメータ:
v - 書き込まれる float
例外:
java.io.IOException - I/O エラーが発生した場合

writeDouble

void writeDouble(double v)
                 throws java.io.IOException
Double クラスの doubleToLongBits メソッドを使って、double 引数を long に変換します。次に、変換された long 値を 8 バイトの量として、高位バイトを先にファイルに書き込みます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeDouble
パラメータ:
v - 書き込まれる double
例外:
java.io.IOException - I/O エラーが発生した場合

writeBytes

void writeBytes(java.lang.String s)
                throws java.io.IOException
文字列をバイトのシーケンスとしてファイルに書き込みます。文字列の各文字は、高位の 8 ビットを破棄して順に書き込まれます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeBytes
パラメータ:
s - 書き込まれるバイトの文字列
例外:
java.io.IOException - I/O エラーが発生した場合

writeChars

void writeChars(java.lang.String s)
                throws java.io.IOException
文字列を文字のシーケンスとしてファイルに書き込みます。各文字は、writeChar メソッドを使用した場合のように、データ出力ストリームに書き込まれます。書き込みは、ファイルポインタの現在の位置で始まります。

定義:
インタフェース java.io.DataOutput 内の writeChars
パラメータ:
s - 書き込まれる String
例外:
java.io.IOException - I/O エラーが発生した場合
関連項目:
writeChar(int)

writeUTF

void writeUTF(java.lang.String str)
              throws java.io.IOException
UTF-8 エンコーディングを使って、マシンに依存するやり方で文字列をファイルに書き込みます。

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

定義:
インタフェース java.io.DataOutput 内の writeUTF
パラメータ:
str - 書き込まれる文字列
例外:
java.io.IOException - I/O エラーが発生した場合


Copyright (c) 2004 Sun Microsystems, Inc. All Rights Reserved