鸿蒙OS Reader

Reader

java.lang.Object

|---java.io.Reader

public abstract class Reader
extends Object
implements Readable, Closeable

用于读取字符流的抽象类。 子类必须实现的唯一方法是 read(char[], int, int) 和 close()。 然而，大多数子类将覆盖此处定义的一些方法，以提供更高的效率、附加功能或两者兼而有之。

Since:

JDK1.1

字段摘要

构造函数摘要

方法总结

字段详细信息

lock

protected Object lock

用于同步此流上的操作的对象。 为了提高效率，字符流对象可以使用自身以外的对象来保护临界区。 因此，子类应该使用该字段中的对象而不是 this 或同步方法。

构造函数详细信息

Reader

protected Reader()

创建一个新的字符流阅读器，其关键部分将在阅读器本身上同步。

Reader

protected Reader(Object lock)

创建一个新的字符流阅读器，其关键部分将在给定对象上同步。

参数：

方法详情

read

public int read(CharBuffer target) throws IOException

尝试将字符读入指定的字符缓冲区。 缓冲区按原样用作字符的存储库：所做的唯一更改是 put 操作的结果。 不执行缓冲区的翻转或倒带。

指定者：

读入接口Readable

参数：

返回:

添加到缓冲区的字符数，如果此字符源位于其末尾，则为 -1

Throws:

Since:

1.5

read

public int read() throws IOException

读取单个字符。 此方法将阻塞，直到字符可用、发生 I/O 错误或到达流的末尾。

打算支持有效的单字符输入的子类应覆盖此方法。

返回:

读取的字符，为 0 到 65535 (0x00-0xffff) 范围内的整数，如果已到达流的末尾，则为 -1

Throws:

read

public int read(char[] cbuf) throws IOException

将字符读入数组。 此方法将阻塞，直到某些输入可用、发生 I/O 错误或到达流的末尾。

参数：

返回:

读取的字符数，如果已到达流的末尾，则为 -1

Throws:

read

public abstract int read(char[] cbuf, int off, int len) throws IOException

将字符读入数组的一部分。 此方法将阻塞，直到某些输入可用、发生 I/O 错误或到达流的末尾。

参数：

返回:

读取的字符数，如果已到达流的末尾，则为 -1

Throws:

skip

public long skip(long n) throws IOException

跳过字符。 此方法将阻塞，直到某些字符可用、发生 I/O 错误或到达流的末尾。

参数：

返回:

实际跳过的字符数

Throws:

ready

public boolean ready() throws IOException

告诉这个流是否准备好被读取。

返回:

如果保证下一个 read() 不会阻塞输入，则为 true，否则为 false。 请注意，返回 false 并不能保证下一次读取将阻塞。

Throws:

markSupported

public boolean markSupported()

告知此流是否支持 mark() 操作。 默认实现总是返回 false。 子类应覆盖此方法。

返回:

当且仅当此流支持标记操作时才为 true。

mark

public void mark(int readAheadLimit) throws IOException

标记流中的当前位置。 对 reset() 的后续调用将尝试将流重新定位到该点。 并非所有字符输入流都支持 mark() 操作。

参数：

Throws:

reset

public void reset() throws IOException

重置流。 如果流已被标记，则尝试将其重新定位在标记处。 如果流尚未被标记，则尝试以适合特定流的某种方式将其重置，例如将其重新定位到其起点。 并非所有字符输入流都支持 reset() 操作，有些支持 reset() 但不支持 mark()。

Throws:

close

public abstract void close() throws IOException

关闭流并释放与其关联的任何系统资源。 关闭流后，进一步的 read()、ready()、mark()、reset() 或 skip() 调用将引发 IOException。 关闭以前关闭的流没有效果。

指定者：

在接口 AutoCloseable 中关闭

指定者：

在接口Closeable中关闭

Throws: