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

BufferedReader

我们提供的服务有:成都网站设计、网站制作、微信公众号开发、网站优化、网站认证、清丰ssl等。为1000+企事业单位解决了网站和推广的问题。提供周到的售前咨询和贴心的售后服务,是有科学管理、有技术的清丰网站制作公司

java.lang.Object

|---java.io.Reader

|---|---java.io.BufferedReader

public class BufferedReader
extends Reader

从字符输入流中读取文本,缓冲字符,以便高效读取字符、数组和行。

可以指定缓冲区大小,也可以使用默认大小。 对于大多数用途,默认值足够大。

通常,由 Reader 发出的每个读取请求都会导致对底层字符或字节流发出相应的读取请求。 因此,建议将 BufferedReader 包装在 read() 操作可能成本高昂的任何 Reader 周围,例如 FileReaders 和 InputStreamReaders。 例如,

 BufferedReader in
   = new BufferedReader(new FileReader("foo.in"));

将缓冲来自指定文件的输入。 如果没有缓冲,每次调用 read() 或 readLine() 都可能导致从文件中读取字节,转换为字符,然后返回,这可能非常低效。

使用 DataInputStreams 进行文本输入的程序可以通过将每个 DataInputStream 替换为适当的 BufferedReader 来本地化。

Since:

JDK1.1

字段摘要

从类 java.io.Reader 继承的字段
lock

构造函数摘要

构造函数描述
BufferedReader(Reader in)创建一个使用默认大小的输入缓冲区的缓冲字符输入流。
BufferedReader(Reader in, int sz)创建一个使用指定大小的输入缓冲区的缓冲字符输入流。

方法总结

修饰符和类型方法描述
voidclose()关闭流并释放与其关联的任何系统资源。
StreamStringlines()返回一个 Stream,其元素是从此 BufferedReader 读取的行。
voidmark(int readAheadLimit)标记流中的当前位置。
booleanmarkSupported()告诉这个流是否支持 mark() 操作,它支持。
intread()读取单个字符。
intread(char[] cbuf, int off, int len)将字符读入数组的一部分。
StringreadLine()读取一行文本。
booleanready()告诉这个流是否准备好被读取。
voidreset()将流重置为最新标记。
longskip(long n)跳过字符。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
从类 java.io.Reader 继承的方法
read, read

构造函数详细信息

BufferedReader

public BufferedReader(Reader in, int sz)

创建一个使用指定大小的输入缓冲区的缓冲字符输入流。

参数:

参数名称参数描述
in输入流
sz输入缓冲区大小

Throws:

Throw名称Throw描述
IllegalArgumentException如果 sz <= 0

BufferedReader

public BufferedReader(Reader in)

创建一个使用默认大小的输入缓冲区的缓冲字符输入流。

参数:

参数名称参数描述
in输入流

方法详情

read

public int read() throws IOException

读取单个字符。

覆盖:

在类输入流中读取

返回:

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

Throws:

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

read

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

将字符读入数组的一部分。

该方法实现了 Reader 类对应的 [Reader#read(char], int, int) 方法的通用约定。 作为额外的便利,它尝试通过重复调用底层流的读取方法来读取尽可能多的字符。 此迭代读取将继续,直到满足以下条件之一:

  • 已读取指定数量的字符,
  • 底层流的read方法返回-1,表示文件结束,或者
  • 底层流的 ready 方法返回 false,表示进一步的输入请求会阻塞。

如果对底层流的第一次读取返回 -1 以指示文件结束,则此方法返回 -1。 否则,此方法返回实际读取的字符数。

鼓励但不要求此类的子类尝试以相同的方式读取尽可能多的字符。

通常,此方法从该流的字符缓冲区中获取字符,并根据需要从底层流中填充它。 但是,如果缓冲区为空,标记无效,并且请求的长度至少与缓冲区一样大,则此方法将直接从底层流中读取字符到给定数组中。 因此冗余的 BufferedReader 不会不必要地复制数据。

指定者:

在类读取流中阅读

参数:

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

返回:

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

Throws:

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

readLine

public String readLine() throws IOException

读取一行文本。 一行被认为是由换行符 ('\n')、回车符 ('\r') 或紧跟换行符的回车符中的任何一个终止的。

返回:

包含行内容的字符串,不包括任何行终止字符,如果已到达流的末尾,则为 null

Throws:

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

skip

public long skip(long n) throws IOException

跳过字符。

覆盖:

skip 类输入流

参数:

参数名称参数描述
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() 操作,它支持。

覆盖:

在阅读器类中标记支持

返回:

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

mark

public void mark(int readAheadLimit) throws IOException

标记流中的当前位置。 对 reset() 的后续调用将尝试将流重新定位到该点。

覆盖:

在类输入流中标记

参数:

参数名称参数描述
readAheadLimit在保留标记的同时限制可以读取的字符数。 在读取达到此限制或超过此限制的字符后尝试重置流可能会失败。 大于输入缓冲区大小的限制值将导致分配一个大小不小于限制的新缓冲区。 因此,应谨慎使用较大的值。

Throws:

Throw名称Throw描述
IllegalArgumentException如果 readAheadLimit < 0
IOException如果发生 I/O 错误

reset

public void reset() throws IOException

将流重置为最新标记。

覆盖:

在输入流类中重置

Throws:

Throw名称Throw描述
IOException如果流从未被标记,或者标记已失效

close

public void close() throws IOException

从班级复制的描述:读者

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

指定者:

在接口 AutoCloseable 中关闭

指定者:

在接口Closeable中关闭

指定者:

关闭类输入流

Throws:

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

lines

public StreamString lines()

返回一个 Stream,其元素是从此 BufferedReader 读取的行。 Stream 是惰性填充的,即在终端流操作期间只读发生。

终端流操作执行过程中不得对阅读器进行操作。否则,终端流操作的结果是不确定的。

执行终端流操作后,不能保证阅读器将处于读取下一个字符或行的特定位置。

如果在访问底层 BufferedReader 时抛出 IOException,它将被包装在 UncheckedIOException 中,该异常将从导致读取发生的 Stream 方法中抛出。如果在关闭的 BufferedReader 上调用此方法,将返回一个 Stream。该流上的任何需要在关闭后从 BufferedReader 读取的操作都将导致抛出 UncheckedIOException。

返回:

提供此 BufferedReader 描述的文本行的 Stream

Since:

1.8

分享标题:创新互联鸿蒙OS教程:鸿蒙OS BufferedReader
地址分享:http://www.shufengxianlan.com/qtweb/news45/108745.html

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

广告

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