国外主机测评 - 国外VPS，国外服务器，国外云服务器，测评及优惠码
BufferedReader
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) | 创建一个使用指定大小的输入缓冲区的缓冲字符输入流。 |
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | close() | 关闭流并释放与其关联的任何系统资源。 |
| StreamString | lines() | 返回一个 Stream，其元素是从此 BufferedReader 读取的行。 |
| void | mark(int readAheadLimit) | 标记流中的当前位置。 |
| boolean | markSupported() | 告诉这个流是否支持 mark() 操作，它支持。 |
| int | read() | 读取单个字符。 |
| int | read(char[] cbuf, int off, int len) | 将字符读入数组的一部分。 |
| String | readLine() | 读取一行文本。 |
| boolean | ready() | 告诉这个流是否准备好被读取。 |
| void | reset() | 将流重置为最新标记。 |
| long | skip(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<String>
Since:
1.8
