树叶云鸿蒙OS教程：鸿蒙OS DataInputStream

DataInputStream

java.lang.Object

|—java.io.InputStream

|—|—java.io.FilterInputStream

|—|—|—java.io.DataInputStream

public class DataInputStream
extends FilterInputStream
implements DataInput

数据输入流允许应用程序以与机器无关的方式从底层输入流中读取原始 Java 数据类型。 应用程序使用数据输出流写入数据，这些数据稍后可以由数据输入流读取。

DataInputStream 对于多线程访问不一定是安全的。 线程安全是可选的，并且是此类中方法的用户的责任。

Since:

JDK1.0

字段摘要

构造函数摘要

方法总结

构造函数详细信息

DataInputStream

public DataInputStream(InputStream in)

创建一个使用指定基础 InputStream 的 DataInputStream。

参数：

方法详情

read

public final int read(byte[] b) throws IOException

从包含的输入流中读取一些字节并将它们存储到缓冲区数组中 b。 实际读取的字节数以整数形式返回。 在输入数据可用、检测到文件结尾或引发异常之前，此方法会一直阻塞。

如果 b 为 null，则抛出 NullPointerException。 如果 b 的长度为零，则不读取任何字节并返回 0； 否则，将尝试读取至少一个字节。 如果由于流位于文件末尾而没有可用字节，则返回值 -1； 否则，至少读取一个字节并将其存储到 b 中。

读取的第一个字节存储在元素 b[0] 中，下一个字节存储在 b[1] 中，依此类推。 读取的字节数最多等于 b 的长度。 设 k 为实际读取的字节数； 这些字节将存储在元素 b[0] 到 b[k-1] 中，而元素 b[k] 到 b[b.length-1] 不受影响。

read(b) 方法具有与以下相同的效果：

 read(b, 0, b.length) 

覆盖：

读入类 FilterInputStream

参数：

返回:

读入缓冲区的总字节数，如果由于到达流的末尾而没有更多数据，则为 -1。

Throws:

read

public final int read(byte[] b, int off, int len) throws IOException

从包含的输入流中读取最多 len 个字节的数据到一个字节数组中。尝试读取多达 len 个字节，但可能会读取较小的字节数，可能为零。实际读取的字节数以整数形式返回。

在输入数据可用、检测到文件结尾或引发异常之前，此方法会一直阻塞。

如果 len 为零，则不读取任何字节并返回 0；否则，将尝试读取至少一个字节。如果由于流位于文件末尾而没有可用字节，则返回值 -1；否则，至少读取一个字节并将其存储到 b 中。

读取的第一个字节存储在元素 b[off] 中，下一个字节存储在 b[off+1] 中，依此类推。读取的字节数最多等于 len。设 k 为实际读取的字节数；这些字节将存储在元素 b[off] 到 b[off+k-1] 中，而元素 b[off+k] 到 b[off+len-1] 不受影响。

在每种情况下，元素 b[0] 到 b[off] 和元素 b[off+len] 到 b[b.length-1] 都不受影响。

覆盖：

读入类 FilterInputStream

参数：

返回:

读入缓冲区的总字节数，如果由于到达流的末尾而没有更多数据，则为 -1。

Throws:

readFully

public final void readFully(byte[] b) throws IOException

请参阅 DataInput 的 readFully 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readFully

参数：

Throws:

readFully

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

请参阅 DataInput 的 readFully 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readFully

参数：

Throws:

skipBytes

public final int skipBytes(int n) throws IOException

请参阅 DataInput 的 skipBytes 方法的一般协定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 skipBytes

参数：

返回:

跳过的实际字节数。

Throws:

readBoolean

public final boolean readBoolean() throws IOException

请参阅 DataInput 的 readBoolean 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readBoolean

返回:

读取的布尔值。

Throws:

readByte

public final byte readByte() throws IOException

请参阅 DataInput 的 readByte 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readByte

返回:

此输入流的下一个字节为有符号的 8 位字节。

Throws:

readUnsignedByte

public final int readUnsignedByte() throws IOException

请参阅 DataInput 的 readUnsignedByte 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readUnsignedByte

返回:

此输入流的下一个字节，解释为无符号 8 位数。

Throws:

readShort

public final short readShort() throws IOException

请参阅 DataInput 的 readShort 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readShort

返回:

此输入流的下两个字节，解释为带符号的 16 位数。

Throws:

readUnsignedShort

public final int readUnsignedShort() throws IOException

请参阅 DataInput 的 readUnsignedShort 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readUnsignedShort

返回:

此输入流的下两个字节，解释为无符号 16 位整数。

Throws:

readChar

public final char readChar() throws IOException

请参阅 DataInput 的 readChar 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readChar

返回:

此输入流的下两个字节，解释为 char。

Throws:

readInt

public final int readInt() throws IOException

请参阅 DataInput 的 readInt 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readInt

返回:

此输入流的下四个字节，解释为 int。

Throws:

readLong

public final long readLong() throws IOException

请参阅 DataInput 的 readLong 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readLong

返回:

此输入流的接下来的 8 个字节，解释为 long。

Throws:

readFloat

public final float readFloat() throws IOException

请参阅 DataInput 的 readFloat 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readFloat

返回:

此输入流的下四个字节，解释为浮点数。

Throws:

readDouble

public final double readDouble() throws IOException

请参阅 DataInput 的 readDouble 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readDouble

返回:

此输入流的接下来的八个字节，解释为双精度。

Throws:

readLine

@Deprecated public final String readLine() throws IOException

已弃用。 此方法不能正确地将字节转换为字符。 从 JDK 1.1 开始，读取文本行的首选方法是通过 BufferedReader.readLine() 方法。 使用 DataInputStream 类读取行的程序可以通过替换形式的代码转换为使用 BufferedReader 类：

     DataInputStream d = new DataInputStream(in); 

with:

     BufferedReader d
          = new BufferedReader(new InputStreamReader(in));

请参阅 DataInput 的 readLine 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readLine

返回:

此输入流中的下一行文本。

Throws:

readUTF

public final String readUTF() throws IOException

请参阅 DataInput 的 readUTF 方法的一般约定。

此操作的字节从包含的输入流中读取。

指定者：

接口 DataInput 中的 readUTF

返回:

一个 Unicode 字符串。

Throws:

readUTF

public static final String readUTF(DataInput in) throws IOException

从流中读取以修改的 UTF-8 格式编码的 Unicode 字符串的表示形式； 然后这个字符串作为字符串返回。 修改后的 UTF-8 表示的细节与 DataInput 的 readUTF 方法完全相同。

参数：

返回:

一个 Unicode 字符串。

Throws: