鸿蒙OS PushbackInputStream

PushbackInputStream

java.lang.Object

|—java.io.InputStream

|—|—java.io.FilterInputStream

|—|—|—java.io.PushbackInputStream

public class PushbackInputStream
extends FilterInputStream

PushbackInputStream 将功能添加到另一个输入流，即“推回”或“未读”一个字节的能力。 这在代码片段可以方便地读取由特定字节值分隔的不确定数量的数据字节的情况下很有用； 读取终止字节后，代码片段可以“取消读取”它，以便对输入流的下一次读取操作将重新读取被推回的字节。 例如，表示构成标识符的字符的字节可能会以表示运算符字符的字节结尾； 一个只读取标识符的方法可以读取，直到它看到运算符，然后将运算符推回以重新读取。

Since:

JDK1.0

字段摘要

构造函数摘要

方法总结

字段详细信息

buf

protected byte[] buf

推回缓冲区。

Since:

JDK1.1

pos

protected int pos

将读取下一个字节的回推缓冲区中的位置。 当缓冲区为空时，pos等于buf.length； 当缓冲区已满时，pos 等于 0。

Since:

JDK1.1

构造函数详细信息

PushbackInputStream

public PushbackInputStream(InputStream in, int size)

创建具有指定大小的推回缓冲区的 PushbackInputStream，并保存其参数，即输入流，以供以后使用。 最初，没有回推字节（字段 pushBack 初始化为 -1）。

参数：

Throws:

Since:

JDK1.1

PushbackInputStream

public PushbackInputStream(InputStream in)

创建一个 PushbackInputStream 并保存其参数，即输入流，以供以后使用。 最初，没有回推字节（字段 pushBack 初始化为 -1）。

参数：

方法详情

read

public int read() throws IOException

从此输入流中读取数据的下一个字节。 值字节作为 int 返回，范围为 0 到 255。如果由于到达流的末尾而没有可用的字节，则返回值 -1。 此方法会一直阻塞，直到输入数据可用、检测到流结束或引发异常。

此方法返回最近推回的字节（如果有），否则调用其底层输入流的 read 方法并返回该方法返回的任何值。

覆盖：

读入类 FilterInputStream

返回:

数据的下一个字节，如果已到达流的末尾，则为 -1。

Throws:

read

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

从此输入流中读取最多 len 个字节的数据到一个字节数组中。 此方法首先读取任何推回的字节； 之后，如果读取的字节数少于 len，则从底层输入流中读取。 如果 len 不为零，则该方法会阻塞，直到至少有 1 个字节的输入可用； 否则，不读取任何字节并返回 0。

覆盖：

读入类 FilterInputStream

参数：

返回:

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

Throws:

unread

public void unread(int b) throws IOException

通过将字节复制到推回缓冲区的前面来推回一个字节。 此方法返回后，下一个要读取的字节将具有值 (byte)b。

参数：

Throws:

unread

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

通过将字节数组的一部分复制到推回缓冲区的前面来推回它。 此方法返回后，要读取的下一个字节将具有值 b[off]，之后的字节将具有值 b[off+1]，依此类推。

参数：

Throws:

Since:

JDK1.1

unread

public void unread(byte[] b) throws IOException

通过将字节数组复制到推回缓冲区的前面来推回它。 此方法返回后，要读取的下一个字节将具有值 b[0]，之后的字节将具有值 b[1]，依此类推。

参数：

Throws:

Since:

JDK1.1

available

public int available() throws IOException

返回可以从此输入流中读取（或跳过）的字节数的估计值，而不会被下一次调用此输入流的方法阻塞。 下一次调用可能是同一个线程或另一个线程。 单次读取或跳过这么多字节不会阻塞，但可能会读取或跳过更少的字节。

该方法返回已被推回的字节数和available返回的值之和。

覆盖：

在类 FilterInputStream 中可用

返回:

可以从输入流中读取（或跳过）而不阻塞的字节数。

Throws:

skip

public long skip(long n) throws IOException

跳过并丢弃此输入流中的 n 字节数据。 由于各种原因，skip 方法最终可能会跳过一些较小的字节数，可能为零。 如果 n 为负数，则不跳过任何字节。

PushbackInputStream 的 skip 方法首先跳过 pushback 缓冲区中的字节（如果有）。 然后，如果需要跳过更多字节，它会调用底层输入流的 skip 方法。 返回实际跳过的字节数。

覆盖：

跳过类 FilterInputStream

参数：

返回:

跳过的实际字节数。

Throws:

Since:

1.2

markSupported

public boolean markSupported()

测试此输入流是否支持 mark 和 reset 方法，但它不支持。

覆盖：

类 FilterInputStream 中的 markSupported

返回:

false，因为此类不支持 mark 和 reset 方法。

mark

public void mark(int readlimit)

标记此输入流中的当前位置。

PushbackInputStream 的 mark 方法什么都不做。

覆盖：

在类 FilterInputStream 中标记

参数：

reset

public void reset() throws IOException

将此流重新定位到最后一次在此输入流上调用标记方法时的位置。

PushbackInputStream 类的方法 reset 除了抛出一个 IOException 之外什么都不做。

覆盖：

在类 FilterInputStream 中重置

Throws:

close

public void close() throws IOException

关闭此输入流并释放与该流关联的所有系统资源。 关闭流后，进一步的 read()、unread()、available()、reset() 或 skip() 调用将引发 IOException。 关闭以前关闭的流没有效果。

指定者：

在接口 AutoCloseable 中关闭

指定者：

在接口Closeable中关闭

覆盖：

在类 FilterInputStream 中关闭

Throws: