创新互联鸿蒙OS教程:鸿蒙OSReader

Reader

为宁都等地区用户提供了全套网页设计制作服务,及宁都网站建设行业解决方案。主营业务为网站制作、网站建设、宁都网站设计,以传统方式定制建设网站,并提供域名空间备案等一条龙服务,秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求,就会得到认可,从而选择与我们长期合作。这样,我们也可以走得更远!

java.lang.Object

|---java.io.Reader

public abstract class Reader
extends Object
implements Readable, Closeable

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

Since:

JDK1.1

字段摘要

修饰符和类型 字段 描述
protected Object lock 用于同步此流上的操作的对象。

构造函数摘要

修饰符 构造函数 描述
protected Reader() 创建一个新的字符流阅读器,其关键部分将在阅读器本身上同步。
protected Reader(Object lock) 创建一个新的字符流阅读器,其关键部分将在给定对象上同步。

方法总结

修饰符和类型 方法 描述
abstract void close() 关闭流并释放与其关联的任何系统资源。
void mark(int readAheadLimit) 标记流中的当前位置。
boolean markSupported() 告知此流是否支持 mark() 操作。
int read() 读取单个字符。
int read(char[] cbuf) 将字符读入数组。
abstract int read(char[] cbuf, int off, int len) 将字符读入数组的一部分。
int read(CharBuffer target) 尝试将字符读入指定的字符缓冲区。
boolean ready() 告诉这个流是否准备好被读取。
void reset() 重置流。
long skip(long n) 跳过字符。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

lock

protected Object lock

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

构造函数详细信息

Reader

protected Reader()

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

Reader

protected Reader(Object lock)

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

参数:

参数名称 参数描述
lock 要同步的对象。

方法详情

read

public int read(CharBuffer target) throws IOException

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

指定者:

读入接口Readable

参数:

参数名称 参数描述
target 将字符读入的缓冲区

返回:

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

Throws:

Throw名称 Throw描述
IOException 如果发生 I/O 错误
NullPointerException 如果 target 为空
ReadOnlyBufferException 如果 target 是只读缓冲区

Since:

1.5

read

public int read() throws IOException

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

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

返回:

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

Throws:

Throw名称 Throw描述
IOException 如果发生 I/O 错误

read

public int read(char[] cbuf) throws IOException

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

参数:

参数名称 参数描述
cbuf 目标缓冲区

返回:

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

Throws:

Throw名称 Throw描述
IOException 如果发生 I/O 错误

read

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

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

参数:

参数名称 参数描述
cbuf 目标缓冲区
off 开始存储字符的偏移量
len 要读取的最大字符数

返回:

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

Throws:

Throw名称 Throw描述
IOException 如果发生 I/O 错误

skip

public long skip(long n) throws IOException

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

参数:

参数名称 参数描述
n 要跳过的字符数

返回:

实际跳过的字符数

Throws:

Throw名称 Throw描述
IllegalArgumentException 如果 n 为负数。
IOException 如果发生 I/O 错误

ready

public boolean ready() throws IOException

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

返回:

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

Throws:

Throw名称 Throw描述
IOException 如果发生 I/O 错误

markSupported

public boolean markSupported()

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

返回:

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

mark

public void mark(int readAheadLimit) throws IOException

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

参数:

参数名称 参数描述
readAheadLimit 在保留标记的同时限制可以读取的字符数。 读取这么多字符后,尝试重置流可能会失败。

Throws:

Throw名称 Throw描述
IOException 如果流不支持 mark(),或者发生其他一些 I/O 错误

reset

public void reset() throws IOException

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

Throws:

Throw名称 Throw描述
IOException 如果流没有被标记,或者标记已经失效,或者流不支持 reset(),或者发生其他一些 I/O 错误

close

public abstract void close() throws IOException

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

指定者:

在接口 AutoCloseable 中关闭

指定者:

在接口Closeable中关闭

Throws:

Throw名称 Throw描述
IOException 如果发生 I/O 错误

网站名称:创新互联鸿蒙OS教程:鸿蒙OSReader
浏览地址:http://www.hantingmc.com/qtweb/news13/9463.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联