|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjava.io.RandomAccessFile
public class RandomAccessFile
このクラスのインスタンスは、ランダムアクセスファイルからの読み込み/書き込みの両方をサポートします。ランダムアクセスファイルの動作は、ファイルシステムに格納されている大規模なバイト配列に似ています。想定される配列には、カーソルのような、「ファイルポインタ」と呼ばれるインデックスがあります。入力処理はファイルポインタ位置から始まる一連のバイトを読み込み、読み込んだバイト分だけファイルポインタを先に進めます。読み込み/書き込みモードで作成されている場合、ランダムアクセスファイルは出力処理にも使用できます。出力処理はファイルポインタ位置から始まる一連のバイトを書き込み、書き込んだバイト分だけファイルポインタを先に進めます。出力処理は、想定された配列の現在の末尾を越えて書き込む場合には、配列が拡張されます。ファイルポインタは getFilePointer
メソッドにより読み込み、seek
メソッドにより設定します。
このクラス内のすべての読み込みルーチンでは、必要なバイト数が読み込まれる前にファイルの終わりに達した場合は、通常、EOFException
(IOException
の一種) がスローされます。ファイルの終わりに達したという以外の理由でバイトの読み込みが失敗した場合は、EOFException
以外の IOException
がスローされます。特に、ストリームが閉じられていると、IOException
がスローされます。
コンストラクタの概要 | |
---|---|
RandomAccessFile(File file,
String mode)
File 引数で指定されたファイルを読み込み元として、また場合によっては書き込み先として、ランダムアクセスファイルストリームを作成します。 |
|
RandomAccessFile(String name,
String mode)
指定された名前を持つファイルからの読み込み、およびオプションで書き込みを行うランダムアクセスファイルストリームを作成します。 |
メソッドの概要 | |
---|---|
void |
close()
このランダムアクセスファイルストリームを終了し、このストリームに関連するすべてのシステムリソースを解放します。 |
FileChannel |
getChannel()
このファイルに関連付けられた、一意の FileChannel オブジェクトを返します。 |
FileDescriptor |
getFD()
このストリームに関連する不透明なファイル記述子を返します。 |
long |
getFilePointer()
このファイルの現在のオフセットを返します。 |
long |
length()
このファイルの長さを返します。 |
int |
read()
このファイルから 1 バイトのデータを読み込みます。 |
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 ビット整数を読み込みます。 |
String |
readLine()
このファイルの次のテキスト行を読み込みます。 |
long |
readLong()
このファイルから符号付きの 64 ビット整数を読み込みます。 |
short |
readShort()
符号付き 16 ビット数をこのファイルから読み込みます。 |
int |
readUnsignedByte()
このファイルから符号なし 8 ビット数を読み込みます。 |
int |
readUnsignedShort()
符号なし 16 ビット数をこのファイルから読み込みます。 |
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)
boolean を 1 バイト値としてファイルに書き込みます。 |
void |
writeByte(int v)
byte を 1 バイト値としてファイルに書き込みます。 |
void |
writeBytes(String s)
文字列を一連のバイトとしてファイルに書き込みます。 |
void |
writeChar(int v)
char を 2 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。 |
void |
writeChars(String s)
文字列を一連の文字としてファイルに書き込みます。 |
void |
writeDouble(double v)
Double クラスの doubleToLongBits メソッドを使って double 引数を long に変換してから、その long 値を 8 バイト値として上位バイトから先にファイルに書き込みます。 |
void |
writeFloat(float v)
Float クラスの floatToIntBits メソッドを使って float 引数を int に変換してから、その int 値を 4 バイト値として上位バイトから先にファイルに書き込みます。 |
void |
writeInt(int v)
int を 4 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。 |
void |
writeLong(long v)
long を 8 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。 |
void |
writeShort(int v)
short を 2 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。 |
void |
writeUTF(String str)
マシンに依存しない修正 UTF-8 エンコーディングを使って、文字列をファイルに書き込みます。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
---|
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
メソッドがファイルへの書き込みアクセスを拒否した場合SecurityException
,
SecurityManager.checkRead(java.lang.String)
,
SecurityManager.checkWrite(java.lang.String)
public RandomAccessFile(File file, String mode) throws FileNotFoundException
File
引数で指定されたファイルを読み込み元として、また場合によっては書き込み先として、ランダムアクセスファイルストリームを作成します。このファイル接続を表す、新しい FileDescriptor
オブジェクトが生成されます。
mode 引数には、ファイルを開くときのアクセスモードを指定します。指定できる値とその意味を次に示します。
"rws" モードと "rwd" モードの動作は、
値
意味
"r" 読み込み用に開く。開いたオブジェクトの任意の write メソッドを呼び出すと、 IOException
がスローされる"rw" 読み込みおよび書き込み用に開く。ファイルが存在しない場合は、作成しようとする "rws" "rw" と同様に、読み込みおよび書き込み用に開く。ファイルの内容またはメタデータを更新したときは、元になる記憶装置にも同時に適用する必要がある "rwd" "rw" と同様に、読み込みおよび書き込み用に開く。ファイルの内容を更新したときは、元になる記憶装置にも同時に適用する必要がある
FileChannel
クラスの force(boolean)
メソッドに true 引数または false 引数を渡した場合にそれぞれ似ています。ただし、これらのモードはすべての入出力操作に適用されるため、より効率的です。ファイルがローカル記憶装置にある場合、このクラスのメソッドを呼び出したときには、ファイルに適用した変更が記憶装置にも常に書き込まれます。この機能を利用すれば、システムに障害が発生したときに重要な情報が失われることがありません。ファイルがローカル記憶装置にない場合は、この規則は適用されません。
"rwd" モードは、実行される入出力操作の数を減らすために使用できます。"rwd" を使用した場合は、ファイルの内容への更新だけが記憶装置に書き込まれます。"rws" を使用した場合は、ファイルの内容とそのメタデータの両方に更新を書き込まれなければなりません。通常は、1 つ以上下位レベルの入出力操作が必要になります。
セキュリティマネージャが存在する場合、ファイルへの読み込みアクセスが許可されているかどうかを確認するために、引数として file
のパス名をとる、セキュリティマネージャの checkRead
メソッドが呼び出されます。書き込みが許可されるモードの場合、ファイルへの書き込みアクセスが許可されているかどうかを確認するために path 引数をとる、セキュリティマネージャの checkWrite
メソッドも呼び出されます。
file
- ファイルオブジェクトmode
- アクセスモード。前述の説明を参照
IllegalArgumentException
- mode 引数が "r"、"rw"、"rws"、または "rwd" でない場合
FileNotFoundException
- モードが "r" だが指定のファイルオブジェクトが既存の普通のファイルを示さない場合。モードが "rw" から始まるが指定のファイルオブジェクトが既存の、書き込み可能な普通のファイルを示さず、その名前を持つ普通のファイルを作成できない場合。またはファイルを開いているときや作成しているときに、その他のエラーが発生した場合
SecurityException
- セキュリティマネージャが存在する場合に、セキュリティマネージャの checkRead
メソッドがファイルへの読み込みアクセスを拒否した場合、あるいはモードが "rw" でセキュリティマネージャの checkWrite
メソッドがファイルへの書き込みアクセスを拒否した場合SecurityManager.checkRead(java.lang.String)
,
SecurityManager.checkWrite(java.lang.String)
,
FileChannel.force(boolean)
メソッドの詳細 |
---|
public final FileDescriptor getFD() throws IOException
IOException
- 入出力エラーが発生した場合FileDescriptor
public final FileChannel getChannel()
FileChannel
オブジェクトを返します。
返されたチャネルの
は常に、position
getFilePointer
メソッドから返されるこのオブジェクトのファイルポインタオフセットと等しくなります。オブジェクトのファイルポインタオフセットを明示的にまたはバイトの読み書きによって変更すると、チャネルの位置も変更されます。チャネルの位置を変更すると、オブジェクトのファイルポインタオフセットも変更されます。このオブジェクトのファイルの長さを変更すると、ファイルチャネルに保持されているファイルの長さも変更されます。ファイルチャネルのファイルの長さを変更すると、オブジェクトのファイルの長さも変更されます。
public int read() throws IOException
0x00-0x0ff
) の範囲の整数として返されます。このメソッドは、有効な入力がまだない場合はブロックします。
RandomAccessFile
は InputStream
のサブクラスではなく、このメソッドの動作は InputStream
の InputStream.read()
メソッドとまったく同じです。
-1
IOException
- 入出力エラーが発生した場合。ファイルの終わりに達した場合はスローされないpublic int read(byte[] b, int off, int len) throws IOException
len
バイトのデータをバイト配列に読み込みます。このメソッドは、少なくとも 1 バイトの入力データが得られるようになるまでブロックします。
RandomAccessFile
は InputStream
のサブクラスではなく、このメソッドの動作は InputStream
の InputStream.read(byte[], int, int)
メソッドとまったく同じです。
b
- データの読み込み先のバッファoff
- データの開始オフセットlen
- 読み込まれる最大バイト数
-1
IOException
- 入出力エラーが発生した場合public int read(byte[] b) throws IOException
b.length
バイトのデータをバイト配列に読み込みます。このメソッドは、少なくとも 1 バイトの入力データが得られるようになるまでブロックします。
RandomAccessFile
は InputStream
のサブクラスではなく、このメソッドの動作は InputStream
の InputStream.read(byte[])
メソッドとまったく同じです。
b
- データの読み込み先のバッファ
-1
IOException
- 入出力エラーが発生した場合public final void readFully(byte[] b) throws IOException
b.length
バイトを読み込みます。このメソッドは、要求されたバイト数になるまでファイルからの読み込みを繰り返します。このメソッドは、要求されたバイト数を読み込むか、ストリームの終わりを検出するか、または例外がスローされるまでブロックします。
DataInput
内の readFully
b
- データの読み込み先のバッファ
EOFException
- すべてのバイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final void readFully(byte[] b, int off, int len) throws IOException
len
バイトを読み込みます。このメソッドは、要求されたバイト数が読み込まれるまでファイルから繰り返し読み込みます。このメソッドは、要求されたバイト数を読み込むか、ストリームの終わりを検出するか、または例外がスローされるまでブロックします。
DataInput
内の readFully
b
- データの読み込み先のバッファoff
- データの開始オフセットlen
- 読み込むバイト数
EOFException
- すべてのバイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public int skipBytes(int n) throws IOException
n
バイトの入力をスキップして、スキップしたバイトを破棄しようとします。
このメソッドは、n
より少ないバイト数 (ゼロの場合もある) しかスキップしない場合もあります。これは、いくつかの条件のうちの 1 つに該当した場合に発生します。n
バイト分をスキップする前にファイルの終わりに達してしまった場合もその 1 つです。このメソッドが EOFException
をスローすることはありません。スキップされた実際のバイト数が返されます。n
が負の値の場合、バイトはスキップされません。
DataInput
内の skipBytes
n
- スキップするバイト数
IOException
- 入出力エラーが発生した場合public void write(int b) throws IOException
DataOutput
内の write
b
- 書き込まれる byte
IOException
- 入出力エラーが発生した場合public void write(byte[] b) throws IOException
b.length
バイトを書き込みます。
DataOutput
内の write
b
- データ
IOException
- 入出力エラーが発生した場合public void write(byte[] b, int off, int len) throws IOException
off
から len
バイトを、このファイルに書き込みます。
DataOutput
内の write
b
- データoff
- データの開始オフセットlen
- 書き込むバイト数
IOException
- 入出力エラーが発生した場合public long getFilePointer() throws IOException
IOException
- 入出力エラーが発生した場合public void seek(long pos) throws IOException
pos
- ファイルの先頭を始点とした、バイト単位のオフセット位置。この位置にファイルポインタが設定される
IOException
- pos
が 0
より小さい場合、あるいは入出力エラーが発生した場合public long length() throws IOException
IOException
- 入出力エラーが発生した場合public void setLength(long newLength) throws IOException
length
メソッドで返されるファイルの現在の長さが newLength
引数よりも大きい場合は、newLength
を超える分は切り捨てられます。この場合、getFilePointer
メソッドで返されるファイルオフセットが newLength
よりも大きければ、このメソッドが復帰したあとのオフセットは newLength
に等しくなります。
length
メソッドで返されるファイルの現在の長さが newLength
引数よりも小さい場合は、ファイルが拡張されます。この場合、ファイルの拡張部分の内容は定義されません。
newLength
- ファイルの必要な長さ
IOException
- 入出力エラーが発生した場合public void close() throws IOException
このファイルに関連付けられているチャネルがある場合は、そのチャネルも閉じます。
Closeable
内の close
IOException
- 入出力エラーが発生した場合public final boolean readBoolean() throws IOException
boolean
を読み込みます。このメソッドは、ファイルの現在のファイルポインタ位置から始めて 1 つのバイトを読み込みます。値 0
は false
を表します。その他の値は true
を表します。このメソッドは、バイトを読み込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readBoolean
boolean
の値
EOFException
- このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final byte readByte() throws IOException
b
の場合、0 <= b <= 255
であれば、結果は次のようになります。(byte)(b)
このメソッドは、バイトを読み込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readByte
byte
として解釈される、このファイルの次のバイト
EOFException
- このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final int readUnsignedByte() throws IOException
このメソッドは、バイトを読み込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readUnsignedByte
EOFException
- このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final short readShort() throws IOException
b1
と b2
の順で、2 つの各値が 0
〜 255
の範囲内の場合、結果は以下と同じになります。(short)((b1 << 8) | b2)
このメソッドは、2 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readShort
EOFException
- 2 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final int readUnsignedShort() throws IOException
b1
と b2
の順で、0 <= b1, b2 <= 255
の場合、結果は以下と同じになります。(b1 << 8) | b2
このメソッドは、2 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readUnsignedShort
EOFException
- 2 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final char readChar() throws IOException
b1
と b2
の順で、0 <= b1, b2 <= 255
の場合、結果は以下と同じになります。(char)((b1 << 8) | b2)
このメソッドは、2 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readChar
EOFException
- 2 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final int readInt() throws IOException
b1
、b2
、b3
、および b4
の順で、0 <= b1, b2, b3, b4 <= 255
の場合、結果は以下と同じになります。(b1 << 24) | (b2 << 16) + (b3 << 8) + b4
このメソッドは、4 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readInt
int
として解釈される、このファイルの次の 4 バイト
EOFException
- 4 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final long readLong() throws IOException
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 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readLong
long
として解釈される、このファイルの次の 8 バイト
EOFException
- 8 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合public final float readFloat() throws IOException
float
を読み込みます。このメソッドは、readInt
メソッドを使うのと同じように現在のファイルポインタ位置から始めて int
値を読み込んでから、Float
クラスの intBitsToFloat
メソッドを使ってその int
を float
に変換します。
このメソッドは、4 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readFloat
float
として解釈される、このファイルの次の 4 バイト
EOFException
- 4 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合readInt()
,
Float.intBitsToFloat(int)
public final double readDouble() throws IOException
double
を読み込みます。このメソッドは、readLong
メソッドを使うのと同じように現在のファイルポインタ位置から始めて long
値を読み込んでから、Double
クラスの longBitsToDouble
メソッドを使ってその long
を double
に変換します。
このメソッドは、8 バイトを読み込むか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readDouble
double
として解釈される、このファイルの次の 8 バイト
EOFException
- 8 バイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合readLong()
,
Double.longBitsToDouble(long)
public final String readLine() throws IOException
テキスト行は、復帰文字 ('\r'
)、改行文字 ('\n'
)、復帰文字の直後に改行文字という組み合わせ、またはファイルの終わりで終了します。行末文字は破棄され、返される文字列の一部には含まれません。
このメソッドは、改行文字が読み込まれるまで、復帰とそれに続くバイトが読み込まれる (改行かどうかを確認する) まで、ファイルの終わりに達するまで、または例外がスローされるまでブロックします。
DataInput
内の readLine
IOException
- 入出力エラーが発生した場合public final String readUTF() throws IOException
readUnsignedShort
を使った場合と同じように、現在のファイルポインタ位置から始めて、最初の 2 バイトが読み込まれます。この値が示すのは、エンコードされた文字列内の後続バイト数です。結果の文字列の長さではありません。後続バイトは修正 UTF-8 形式でエンコードされた文字として解釈され、文字に変換されます。
このメソッドは、すべてのバイトを読み込み終わるか、ストリームの終わりが検出されるか、または例外がスローされるまでブロックします。
DataInput
内の readUTF
EOFException
- すべてのバイトを読み込む前に、このファイルの終わりに達した場合
IOException
- 入出力エラーが発生した場合
UTFDataFormatException
- バイトが有効な修正 UTF-8 の Unicode 文字列を表さない場合readUnsignedShort()
public final void writeBoolean(boolean v) throws IOException
boolean
を 1 バイト値としてファイルに書き込みます。値 true
は値 (byte)1
として書き込まれ、値 false
は値 (byte)0
として書き込まれます。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeBoolean
v
- 書き込まれる boolean
値
IOException
- 入出力エラーが発生した場合public final void writeByte(int v) throws IOException
byte
を 1 バイト値としてファイルに書き込みます。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeByte
v
- 書き込まれる byte
値
IOException
- 入出力エラーが発生した場合public final void writeShort(int v) throws IOException
short
を 2 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeShort
v
- 書き込まれる short
値
IOException
- 入出力エラーが発生した場合public final void writeChar(int v) throws IOException
char
を 2 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeChar
v
- 書き込まれる char
値
IOException
- 入出力エラーが発生した場合public final void writeInt(int v) throws IOException
int
を 4 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeInt
v
- 書き込まれる int
値
IOException
- 入出力エラーが発生した場合public final void writeLong(long v) throws IOException
long
を 8 バイト値としてファイルに書き込みます (上位バイトから先に書き込む)。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeLong
v
- 書き込まれる long
値
IOException
- 入出力エラーが発生した場合public final void writeFloat(float v) throws IOException
Float
クラスの floatToIntBits
メソッドを使って float 引数を int
に変換してから、その int
値を 4 バイト値として上位バイトから先にファイルに書き込みます。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeFloat
v
- 書き込まれる float
値
IOException
- 入出力エラーが発生した場合Float.floatToIntBits(float)
public final void writeDouble(double v) throws IOException
Double
クラスの doubleToLongBits
メソッドを使って double 引数を long
に変換してから、その long
値を 8 バイト値として上位バイトから先にファイルに書き込みます。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeDouble
v
- 書き込まれる double
値
IOException
- 入出力エラーが発生した場合Double.doubleToLongBits(double)
public final void writeBytes(String s) throws IOException
DataOutput
内の writeBytes
s
- 書き込まれるバイトの文字列
IOException
- 入出力エラーが発生した場合public final void writeChars(String s) throws IOException
writeChar
メソッドのようにしてデータ出力ストリームに書き込まれます。書き込みは、ファイルポインタの現在位置から開始されます。
DataOutput
内の writeChars
s
- 書き込まれる String
値
IOException
- 入出力エラーが発生した場合writeChar(int)
public final void writeUTF(String str) throws IOException
まず、後続のバイト数を指定する writeShort
メソッドを使った場合と同じように、現在のファイルポインタ位置から始めて 2 バイトがファイルに書き込まれます。この値は、実際に書き込まれるバイト数です。文字列の長さではありません。長さに続いて、文字列の各文字が、文字ごとに修正 UTF-8 エンコーディングを使って順に出力されます。
DataOutput
内の writeUTF
str
- 書き込まれる文字列
IOException
- 入出力エラーが発生した場合
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。