Java java.io 接口 DataInput（JDK5）

所有类

java.io
接口 DataInput

所有已知子接口：

ImageInputStream, ImageOutputStream, ObjectInput

所有已知实现类：

DataInputStream, FileCacheImageInputStream, FileCacheImageOutputStream, FileImageInputStream, FileImageOutputStream, ImageInputStreamImpl, ImageOutputStreamImpl, MemoryCacheImageInputStream, MemoryCacheImageOutputStream, ObjectInputStream, RandomAccessFile

public interface DataInput

DataInput 接口用于从二进制流中读取字节，并重构所有 Java 基本类型数据。同时还提供根据 UTF-8 修改版格式的数据重构 String 的工具。

对于此接口中的所有数据读取例程来说，如果在读取到所需字节数的数据之前已经到达文件末尾 (end of file)，则都将抛出 EOFException（IOException 的一种）。如果因为文件末尾以外的其他原因无法读取字节，则抛出 IOException 而不是 EOFException。尤其在输入流已关闭的情况下，将抛出 IOException。

UTF-8 修改版

DataInput 和 DataOutput 接口的实现表示稍微改版的 UTF-8 格式的 Unicode 字符串。（关于标准 UTF-8 格式的信息，请参阅 The Unicode Standard, Version 4.0 的 3.9 Unicode Encoding Forms 小节）。注意，在下表中，最高有效位显示在最左边的列中。

'\u0001' 到 '\u007F' 范围内的所有字符由单个字节表示：

	位值
字节 1	0 位 6-0

null 字符 '\u0000' 和 '\u0080' 到 '\u07FF' 范围内的字符由一对字节表示：

	位值
字节 1	1 1 0 位 10-6
字节 2	1 0 位 5-0

	位值
字节 1	1 1 1 0 位 15-12
字节 2	1 0 位 11-6
字节 3	1 0 位 5-0

这种格式与标准 UTF-8 格式之间的不同如下：

• null 字节 '\u0000' 是用 2-byte 格式而不是 1-byte 格式编码的，因此已编码的字符串中决不会有嵌入的 null。
• 仅使用 1-byte、2-byte 和 3-byte 格式。
• 增补字符是以代理项对的形式表示的。

从以下版本开始：

JDK1.0

另请参见：

DataInputStream, DataOutput

readFully

void readFully(byte[] b)
               throws IOException

从输入流中读取一些字节，并将它们存储到缓冲区数组 b 中。读取的字节数等于 b 的长度。

在出现以下条件之一前，此方法将阻塞：

• 输入数据的 b.length 个字节是可用的，在这种情况下，正常返回。
• 检测到文件末尾，在这种情况下，抛出 EOFException。
• 发生 I/O 错误，在这种情况下，将抛出 IOException，而不是 EOFException。

如果 b 为 null，则抛出 NullPointerException。如果 b.length 为零，则不读取字节。否则，将读取的第一个字节存储到元素 b[0] 中，下一个字节存储到 b[1] 中，依此类推。如果此方法抛出异常，则可能是因为已经用输入流中的数据更新了 b 的某些（但非全部）字节。

参数：

b - 存储读取数据的缓冲区。

抛出：

EOFException - 如果此流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readFully

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

从输入流中读取 len 个字节。

在出现以下条件之一以前，此方法将阻塞：

• 输入数据的 len 个字节是可用的，在这种情况下，正常返回。
• 检测到文件末尾，在这种情况下，抛出 EOFException。
• 如果发生 I/O 错误，在这种情况下，将抛出 IOException，而不是 EOFException。

如果 b 为 null，则抛出 NullPointerException。如果 off 为负，或 len 为负，抑或 off+len 大于数组 b 的长度，则抛出 IndexOutOfBoundsException。如果 len 为零，则不读取字节。否则，将读取的第一个字节存储到元素 b[off] 中，下一个字节存储到 b[off+1] 中，依此类推。读取的字节数至多等于 b[0]。

参数：

b - 存储读取数据的缓冲区。

off - 指定数据中的偏移量的 int。

len - 指定读取的字节数的 int。

抛出：

EOFException - 如果此流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

skipBytes

int skipBytes(int n)
              throws IOException

试图在输入流中跳过数据的 n 个字节，并丢弃跳过的字节。不过，它可以跳过更少的字节数，该字节数甚至可能为零。这可能由很多情况引起；在已经跳过 n 个字节前到达文件末尾只是其中的一种可能。此方法从不抛出 EOFException。返回实际跳过的字节数。

参数：

n - 要跳过的字节数。

返回：

实际跳过的字节数。

抛出：

IOException - 如果发生 I/O 错误。

readBoolean

boolean readBoolean()
                    throws IOException

读取一个输入字节，如果该字节不是零，则返回 true，如果是零，则返回 false。此方法适用于读取用接口 DataOutput 的 writeBoolean 方法写入的字节。

返回：

读取的 boolean 值。

抛出：

EOFException - 如果此流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readByte

byte readByte()
              throws IOException

读取并返回一个输入字节。该字节被看作是 -128 到 127（包含）范围内的一个有符号值。此方法适用于读取用接口 DataOutput 的 writeByte 方法写入的字节。

返回：

读取的 8 位值。

抛出：

EOFException - 如果此流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readUnsignedByte

int readUnsignedByte()
                     throws IOException

读取一个输入字节，将它左侧补零 (zero-extend) 转变为 int 类型，并返回结果，所以结果的范围是 0 到 255。如果接口 DataOutput 的 writeByte 方法的参数是 0 到 255 之间的值，则此方法适用于读取用 writeByte 写入的字节。

返回：

读取的无符号 8 位值。

抛出：

EOFException - 如果此流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。

readShort

short readShort()
                throws IOException

读取两个输入字节并返回一个 short 值。设 a 为第一个读取字节，b 为第二个读取字节。返回的值是：

(short)((a << 8) | (b & 0xff))
 

此方法适用于读取用接口 DataOutput 的 writeShort 方法写入的字节。

返回：

读取的 16 位值。

抛出：

EOFException - 如果此流在读取所有字节之前到达末尾。

IOException - 如果发生 I/O 错误。