java.lang.Object
|---java.io.RandomAccessFile
public class RandomAccessFile
extends Object
implements DataOutput, DataInput, Closeable
此类的实例支持读取和写入随机访问文件。随机访问文件的行为类似于存储在文件系统中的大型字节数组。有一种游标，或隐含数组的索引，称为文件指针；输入操作从文件指针开始读取字节，并将文件指针推进超过读取的字节。如果随机存取文件是以读/写模式创建的，那么输出操作也是可用的；输出操作从文件指针开始写入字节，并将文件指针前进到写入的字节。写入隐含数组当前末尾的输出操作会导致数组被扩展。文件指针可以通过 getFilePointer 方法读取并通过 seek 方法设置。
对于此类中的所有读取例程，通常情况下，如果在读取所需的字节数之前到达文件结尾，则会抛出 EOFException（这是一种 IOException）。如果由于文件结尾以外的任何原因无法读取任何字节，则会引发除 EOFException 之外的 IOException。特别是，如果流已关闭，则可能会引发 IOException。
Since:
JDK1.0
| 构造函数 | 描述 |
|---|---|
| RandomAccessFile(File file, String mode) | 创建一个随机访问文件流，以读取和写入由 File 参数指定的文件。 |
| RandomAccessFile(String name, String mode) | 创建一个随机访问文件流，以读取和写入具有指定名称的文件。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | close() | 关闭此随机访问文件流并释放与该流关联的所有系统资源。 |
| FileChannel | getChannel() | 返回与此文件关联的唯一 FileChannel 对象。 |
| FileDescriptor | getFD() | 返回与此流关联的不透明文件描述符对象。 |
| long | getFilePointer() | 返回此文件中的当前偏移量。 |
| long | length() | 返回此文件的长度。 |
| int | read() | 从此文件中读取一个字节的数据。 |
| int | read(byte[] b) | 从此文件中读取最多 b.length 个字节的数据到字节数组中。 |
| int | read(byte[] b, int off, int len) | 从此文件中读取最多 len 个字节的数据到一个字节数组中。 |
| boolean | readBoolean() | 从此文件中读取一个布尔值。 |
| byte | readByte() | 从此文件中读取一个有符号的 8 位值。 |
| char | readChar() | 从此文件中读取一个字符。 |
| double | readDouble() | 从此文件中读取一个 double。 |
| float | readFloat() | 从此文件中读取一个浮点数。 |
| 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() | 从此文件中读取一个无符号八位数。 |
| 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) | 将布尔值作为单字节值写入文件。 |
| void | writeByte(int v) | 将一个字节作为单字节值写入文件。 |
| void | writeBytes(String s) | 将字符串作为字节序列写入文件。 |
| void | writeChar(int v) | 将 char 作为两字节值写入文件，先是高字节。 |
| void | writeChars(String s) | 将字符串作为字符序列写入文件。 |
| void | writeDouble(double v) | 使用 Double 类中的 doubleToLongBits 方法将 double 参数转换为 long，然后将该 long 值作为 8 字节数量写入文件，先是高字节。 |
| void | writeFloat(float v) | 使用 Float 类中的 floatToIntBits 方法将 float 参数转换为 int，然后将该 int 值作为四字节数量写入文件，先是高字节。 |
| void | writeInt(int v) | 将 int 作为四个字节写入文件，先是高字节。 |
| void | writeLong(long v) | 将 long 作为 8 个字节写入文件，先是高字节。 |
| void | writeShort(int v) | 以两个字节的形式向文件写入一个short，首先是高字节。 |
| 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) 构造函数指定的一样。
如果有安全管理器，则调用其 checkRead 方法，并使用 name 参数作为其参数，以查看是否允许对文件进行读取访问。 如果该模式允许写入，则还调用安全管理器的 checkWrite 方法，并将 name 参数作为其参数，以查看是否允许对文件进行写入访问。
参数：
| 参数名称 | 参数描述 |
|---|---|
| name | 系统相关的文件名 |
| mode | 访问模式 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果模式参数不等于“r”、“rw”、“rws”或“rwd”之一 |
| FileNotFoundException | 如果模式为“r”但给定的字符串不表示现有的常规文件，或者如果模式以“rw”开头但给定的字符串不表示现有的可写常规文件并且该名称的新常规文件不能 被创建，或者在打开或创建文件时发生其他错误 |
| SecurityException | 如果安全管理器存在且其 checkRead 方法拒绝对文件的读访问或模式为“rw”且安全管理器的 checkWrite 方法拒绝对文件的写访问 |
public RandomAccessFile(File file, String mode) throws FileNotFoundException
创建一个随机访问文件流，以读取和写入由 File 参数指定的文件。创建一个新的 FileDescriptor 对象来表示此文件连接。
mode 参数指定打开文件的访问模式。允许的值及其含义是：
“rws”和“rwd”模式的工作方式很像 FileChannel 类的 force(boolean) 方法，分别传递 true 和 false 的参数，除了它们总是适用于每个 I/O 操作，因此通常更有效。如果文件驻留在本地存储设备上，则当调用此类的方法返回时，可以保证该调用对文件所做的所有更改都已写入该设备。这对于确保在系统崩溃时不会丢失关键信息很有用。如果文件不驻留在本地设备上，则不会做出此类保证。
“rwd”模式可用于减少执行的 I/O 操作的数量。使用“rwd”只需要更新要写入存储的文件内容；使用“rws”需要更新文件的内容和要写入的元数据，这通常需要至少一个低级 I/O 操作。
如果有安全管理器，则调用其 checkRead 方法，并以文件参数的路径名作为其参数，以查看是否允许对文件进行读取访问。如果该模式允许写入，还使用路径参数调用安全管理器的 checkWrite 方法，以查看是否允许对文件进行写入访问。
参数：
| 参数名称 | 参数描述 |
|---|---|
| file | 文件对象 |
| mode | 访问模式，如上所述 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果模式参数不等于“r”、“rw”、“rws”或“rwd”之一 |
| FileNotFoundException | 如果模式为“r”但给定的文件对象不表示现有的常规文件，或者如果模式以“rw”开头但给定的文件对象不表示现有的可写常规文件和该文件的新常规文件 无法创建名称，或者在打开或创建文件时出现其他错误 |
| SecurityException | 如果安全管理器存在且其 checkRead 方法拒绝对文件的读访问或模式为“rw”且安全管理器的 checkWrite 方法拒绝对文件的写访问 |
public final FileDescriptor getFD() throws IOException
返回与此流关联的不透明文件描述符对象。
返回:
与此流关联的文件描述符对象。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final FileChannel getChannel()
返回与此文件关联的唯一 FileChannel 对象。
返回通道的位置将始终等于 getFilePointer 方法返回的该对象的文件指针偏移量。 更改此对象的文件指针偏移量，无论是显式地还是通过读取或写入字节，都会改变通道的位置，反之亦然。 通过此对象更改文件的长度将更改通过文件通道看到的长度，反之亦然。
返回:
与此文件关联的文件通道
Since:
1.4
public int read() throws IOException
从此文件中读取一个字节的数据。 该字节以 0 到 255 (0x00-0x0ff) 范围内的整数形式返回。 如果还没有输入可用，则此方法会阻塞。
尽管 RandomAccessFile 不是 InputStream 的子类，但此方法的行为方式与 InputStream 的 InputStream#read() 方法完全相同。
返回:
数据的下一个字节，如果已到达文件末尾，则为 -1。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 如果已到达文件结尾，则不抛出。 |
public int read(byte[] b, int off, int len) throws IOException
从此文件中读取最多 len 个字节的数据到一个字节数组中。 此方法会阻塞，直到至少有一个字节的输入可用。
尽管 RandomAccessFile 不是 InputStream 的子类，但此方法的行为方式与 InputStream 的 [InputStream#read(byte], int, int) 方法完全相同。
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 读取数据的缓冲区。 |
| off | 数组 b 中写入数据的起始偏移量。 |
| len | 读取的最大字节数。 |
返回:
读入缓冲区的总字节数，如果由于已到达文件末尾而没有更多数据，则为 -1。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果由于文件结尾以外的任何原因无法读取第一个字节，或者随机访问文件已关闭，或者发生其他一些 I/O 错误。 |
| NullPointerException | 如果 b 为空。 |
| IndexOutOfBoundsException | 如果 off 为负数，len 为负数，或者 len 大于 b.length - off |
public int read(byte[] b) throws IOException
从此文件中读取最多 b.length 个字节的数据到字节数组中。 此方法会阻塞，直到至少有一个字节的输入可用。
尽管 RandomAccessFile 不是 InputStream 的子类，但此方法的行为方式与 InputStream 的 [InputStream#read(byte]) 方法完全相同。
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 读取数据的缓冲区。 |
返回:
读入缓冲区的总字节数，如果由于已到达此文件的末尾而没有更多数据，则为 -1。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果由于文件结尾以外的任何原因无法读取第一个字节，或者随机访问文件已关闭，或者发生其他一些 I/O 错误。 |
| NullPointerException | 如果 b 为空。 |
public final void readFully(byte[] b) throws IOException
从此文件中读取 b.length 个字节到字节数组中，从当前文件指针开始。 此方法从文件中重复读取，直到读取请求的字节数。 此方法会一直阻塞，直到读取到请求的字节数、检测到流的结尾或引发异常。
指定者：
接口 DataInput 中的 readFully
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 读取数据的缓冲区。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取所有字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final void readFully(byte[] b, int off, int len) throws IOException
从当前文件指针开始，从该文件准确读取 len 个字节到字节数组中。 此方法从文件中重复读取，直到读取请求的字节数。 此方法会一直阻塞，直到读取到请求的字节数、检测到流的结尾或引发异常。
指定者：
接口 DataInput 中的 readFully
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 读取数据的缓冲区。 |
| off | 数据的起始偏移量。 |
| len | 要读取的字节数。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取所有字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public int skipBytes(int n) throws IOException
尝试跳过 n 个字节的输入丢弃跳过的字节。
此方法可能会跳过一些较小的字节数，可能为零。 这可能是由多种情况中的任何一种造成的； 在跳过 n 个字节之前到达文件末尾只是一种可能性。 此方法从不抛出 EOFException。 返回实际跳过的字节数。 如果 n 为负数，则不跳过任何字节。
指定者：
接口 DataInput 中的 skipBytes
参数：
| 参数名称 | 参数描述 |
|---|---|
| n | 要跳过的字节数。 |
返回:
跳过的实际字节数。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public void write(int b) throws IOException
将指定的字节写入此文件。 写入从当前文件指针开始。
指定者：
写入接口DataOutput
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 要写入的字节。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public void write(byte[] b) throws IOException
将指定字节数组中的 b.length 个字节写入此文件，从当前文件指针开始。
指定者：
写入接口DataOutput
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 数据。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public void write(byte[] b, int off, int len) throws IOException
从偏移量 off 开始的指定字节数组中写入 len 个字节到此文件。
指定者：
写入接口DataOutput
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 数据。 |
| off | 数据中的起始偏移量。 |
| len | 要写入的字节数。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public long getFilePointer() throws IOException
返回此文件中的当前偏移量。
返回:
从文件开头的偏移量，以字节为单位，发生下一次读取或写入。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public void seek(long pos) throws IOException
设置文件指针偏移量，从该文件的开头开始测量，下一次读取或写入发生在该位置。 偏移量可以设置在文件末尾之外。 设置超出文件末尾的偏移量不会更改文件长度。 只有在将偏移量设置到文件末尾之后，文件长度才会改变。
参数：
| 参数名称 | 参数描述 |
|---|---|
| pos | 偏移位置，以从文件开头开始的字节为单位，设置文件指针的位置。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果 pos 小于 0 或发生 I/O 错误。 |
public long length() throws IOException
返回此文件的长度。
返回:
此文件的长度，以字节为单位。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public void setLength(long newLength) throws IOException
设置此文件的长度。
如果 length 方法返回的文件的当前长度大于 newLength 参数，则文件将被截断。 在这种情况下，如果 getFilePointer 方法返回的文件偏移量大于 newLength，则在此方法返回后，偏移量将等于 newLength。
如果 length 方法返回的文件的当前长度小于 newLength 参数，则文件将被扩展。 在这种情况下，未定义文件扩展部分的内容。
参数：
| 参数名称 | 参数描述 |
|---|---|
| newLength | 所需的文件长度 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
Since:
1.2
public void close() throws IOException
关闭此随机访问文件流并释放与该流关联的所有系统资源。 关闭的随机存取文件无法执行输入或输出操作，也无法重新打开。
如果此文件具有关联的通道，则该通道也将关闭。
指定者：
在接口 AutoCloseable 中关闭
指定者：
在接口Closeable中关闭
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final boolean readBoolean() throws IOException
从此文件中读取一个布尔值。 此方法从文件中读取单个字节，从当前文件指针开始。 值 0 表示假。 任何其他值都表示真。 此方法一直阻塞，直到读取字节、检测到流的结尾或引发异常。
指定者：
接口 DataInput 中的 readBoolean
返回:
读取的布尔值。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果这个文件已经结束。 |
| IOException | 如果发生 I/O 错误。 |
public final byte readByte() throws IOException
从此文件中读取一个有符号的 8 位值。 此方法从文件中读取一个字节，从当前文件指针开始。 如果读取的字节为 b，其中 0 <= b <= 255，则结果为：
(byte)(b)
此方法一直阻塞，直到读取字节、检测到流的结尾或引发异常。
指定者：
接口 DataInput 中的 readByte
返回:
此文件的下一个字节为有符号的 8 位字节。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果这个文件已经结束。 |
| IOException | 如果发生 I/O 错误。 |
public final int readUnsignedByte() throws IOException
从此文件中读取一个无符号八位数。 此方法从该文件中读取一个字节，从当前文件指针开始，并返回该字节。
此方法一直阻塞，直到读取字节、检测到流的结尾或引发异常。
指定者：
接口 DataInput 中的 readUnsignedByte
返回:
此文件的下一个字节，解释为无符号八位数。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果这个文件已经结束。 |
| IOException | 如果发生 I/O 错误。 |
public final short readShort() throws IOException
从此文件中读取一个带符号的 16 位数字。 该方法从该文件中读取两个字节，从当前文件指针开始。 如果按顺序读取的两个字节是 b1 和 b2，其中两个值中的每一个都介于 0 和 255 之间，包括 0 和 255，则结果等于：
(short)((b1 << 8) | b2)
此方法一直阻塞，直到读取了两个字节、检测到流结束或抛出异常。
指定者：
接口 DataInput 中的 readShort
返回:
该文件的下两个字节，解释为带符号的 16 位数字。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取两个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final int readUnsignedShort() throws IOException
从此文件中读取一个无符号的 16 位数字。 此方法从文件中读取两个字节，从当前文件指针开始。 如果按顺序读取的字节是 b1 和 b2，其中 0 <= b1，b2 <= 255，则结果等于：
(b1 << 8) | b2
此方法一直阻塞，直到读取了两个字节、检测到流结束或抛出异常。
指定者：
接口 DataInput 中的 readUnsignedShort
返回:
此文件的下两个字节，解释为无符号 16 位整数。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取两个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final char readChar() throws IOException
从此文件中读取一个字符。 此方法从文件中读取两个字节，从当前文件指针开始。 如果按顺序读取的字节是 b1 和 b2，其中 0 <= b1，b2 <= 255，则结果等于：
(char)((b1 << 8) | b2)
此方法一直阻塞，直到读取了两个字节、检测到流结束或抛出异常。
指定者：
接口 DataInput 中的 readChar
返回:
该文件的下两个字节，解释为一个字符。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取两个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final int readInt() throws IOException
从此文件中读取一个带符号的 32 位整数。 此方法从文件中读取 4 个字节，从当前文件指针开始。 如果按顺序读取的字节是 b1、b2、b3 和 b4，其中 0 <= b1、b2、b3、b4 <= 255，则结果等于：
(b1 << 24) | (b2 << 16) + (b3 << 8) + b4
此方法一直阻塞，直到读取了四个字节、检测到流的结尾或抛出异常。
指定者：
接口 DataInput 中的 readInt
返回:
此文件的下四个字节，解释为 int。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取四个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final long readLong() throws IOException
从此文件中读取一个带符号的 64 位整数。 此方法从文件中读取八个字节，从当前文件指针开始。 如果按顺序读取的字节是 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
返回:
该文件的接下来的 8 个字节，解释为 long。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取八个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final float readFloat() throws IOException
从此文件中读取一个浮点数。 此方法从当前文件指针开始读取一个 int 值，就像通过 readInt 方法一样，然后使用 Float 类中的 intBitsToFloat 方法将该 int 转换为浮点数。
此方法一直阻塞，直到读取了四个字节、检测到流的结尾或抛出异常。
指定者：
接口 DataInput 中的 readFloat
返回:
此文件的下四个字节，解释为浮点数。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取四个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final double readDouble() throws IOException
从此文件中读取一个 double。 此方法从当前文件指针开始读取一个 long 值，就像通过 readLong 方法一样，然后使用 Double 类中的 longBitsToDouble 方法将该 long 转换为 double。
此方法一直阻塞，直到读取了 8 个字节、检测到流结束或引发异常。
指定者：
接口 DataInput 中的 readDouble
返回:
此文件的下八个字节，解释为双精度。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取八个字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
public final String readLine() throws IOException
从此文件中读取下一行文本。此方法从文件中连续读取字节，从当前文件指针开始，直到到达行终止符或文件末尾。通过获取字符低八位的字节值并将字符的高八位设置为零，将每个字节转换为字符。因此，此方法不支持完整的 Unicode 字符集。
一行文本由回车符 ('\r')、换行符 ('\n')、紧跟换行符的回车符或文件结尾终止。行终止字符被丢弃，并且不包含在返回的字符串中。
此方法阻塞，直到读取换行符、读取回车符和其后的字节（以查看是否为换行符）、到达文件末尾或引发异常。
指定者：
接口 DataInput 中的 readLine
返回：
此文件中的下一行文本，如果在读取一个字节之前遇到文件结尾，则为 null。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final String readUTF() throws IOException
从此文件中读取字符串。 该字符串已使用修改后的 UTF-8 格式进行编码。
从当前文件指针开始读取前两个字节，就像通过 readUnsignedShort 一样。 该值给出了编码字符串中的后续字节数，而不是结果字符串的长度。 随后的字节被解释为字节编码字符在修改的 UTF-8 格式，并被转换成字符。
此方法阻塞，直到读取所有字节、检测到流的结尾或引发异常。
指定者：
接口 DataInput 中的 readUTF
返回:
一个 Unicode 字符串。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| EOFException | 如果此文件在读取所有字节之前到达末尾。 |
| IOException | 如果发生 I/O 错误。 |
| UTFDataFormatException | 如果字节不代表 Unicode 字符串的有效修改 UTF-8 编码。 |
public final void writeBoolean(boolean v) throws IOException
将布尔值作为单字节值写入文件。 值 true 被写为值（字节）1； 值 false 被写为值（字节）0。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeBoolean
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的布尔值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeByte(int v) throws IOException
将一个字节作为单字节值写入文件。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeByte
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的字节值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeShort(int v) throws IOException
以两个字节的形式向文件写入一个short，首先是高字节。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeShort
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的 short 值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeChar(int v) throws IOException
将 char 作为两字节值写入文件，先是高字节。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeChar
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的 char 值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeInt(int v) throws IOException
将 int 作为四个字节写入文件，先是高字节。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeInt
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的 int。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeLong(long v) throws IOException
将 long 作为 8 个字节写入文件，先是高字节。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeLong
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的 long 值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeFloat(float v) throws IOException
使用 Float 类中的 floatToIntBits 方法将 float 参数转换为 int，然后将该 int 值作为四字节数量写入文件，先是高字节。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeFloat
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的浮点值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeDouble(double v) throws IOException
使用 Double 类中的 doubleToLongBits 方法将 double 参数转换为 long，然后将该 long 值作为 8 字节数量写入文件，先是高字节。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeDouble
参数：
| 参数名称 | 参数描述 |
|---|---|
| v | 要写入的 double 值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeBytes(String s) throws IOException
将字符串作为字节序列写入文件。 字符串中的每个字符通过丢弃其高八位按顺序写出。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeBytes
参数：
| 参数名称 | 参数描述 |
|---|---|
| s | 要写入的字节串。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeChars(String s) throws IOException
将字符串作为字符序列写入文件。 每个字符都被写入数据输出流，就像通过 writeChar 方法一样。 写入从文件指针的当前位置开始。
指定者：
接口 DataOutput 中的 writeChars
参数：
| 参数名称 | 参数描述 |
|---|---|
| s | 要写入的字符串值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
public final void writeUTF(String str) throws IOException
以与机器无关的方式使用修改后的 UTF-8 编码将字符串写入文件。
首先，将两个字节写入文件，从当前文件指针开始，就好像通过 writeShort 方法给出了后面的字节数。 这个值是实际写出的字节数，而不是字符串的长度。 在长度之后，按顺序输出字符串的每个字符，对每个字符使用修改后的 UTF-8 编码。
指定者：
接口 DataOutput 中的 writeUTF
参数：
| 参数名称 | 参数描述 |
|---|---|
| str | 要写入的字符串。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。