BufferedReader (Java Platform SE 8 )

java.lang.Object
- java.io.Reader
- - java.io.BufferedReader

All Implemented Interfaces:

Closeable ， AutoCloseable ， Readable

已知直接子类：

LineNumberReader
```
public class BufferedReader
extends Reader
```
从字符输入流读取文本，缓冲字符，以提供字符，数组和行的高效读取。
可以指定缓冲区大小，或者可以使用默认大小。默认值足够大，可用于大多数用途。

通常，由读取器做出的每个读取请求将引起对底层字符或字节流的相应读取请求。因此，建议将BufferedReader包装在其read（）操作可能昂贵的读取器上，例如FileReaders和InputStreamReaders。例如，
```
  BufferedReader in
   = new BufferedReader(new FileReader("foo.in")); 
```
将缓冲指定文件的输入。没有缓冲，每次调用read（）或readLine（）可能会导致从文件中读取字节，转换成字符，然后返回，这可能非常低效。
使用DataInputStreams进行文本输入的程序可以通过用适当的BufferedReader替换每个DataInputStream进行本地化。
从以下版本开始：

JDK1.1

另请参见：

FileReader ， InputStreamReader ， Files.newBufferedReader(java.nio.file.Path, java.nio.charset.Charset)

Field Summary
- Fields inherited from class java.io.Reader
  lock

构造方法摘要

构造方法
Constructor and Description
`BufferedReader(Reader in)` 创建使用默认大小的输入缓冲区的缓冲字符输入流。
`BufferedReader(Reader in, int sz)` 创建使用指定大小的输入缓冲区的缓冲字符输入流。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`close()` 关闭流并释放与之相关联的任何系统资源。
`Stream<String>`	`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)` 跳过字符

Methods inherited from class java.io.Reader
read, read

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - BufferedReader
```
public BufferedReader(Reader in,
                      int sz)
```
    创建使用指定大小的输入缓冲区的缓冲字符输入流。
    
    参数
    
    in - 阅读器
    
    sz - 输入缓冲区大小
    
    异常
    
    IllegalArgumentException - 如果 sz <= 0
  - BufferedReader
```
public BufferedReader(Reader in)
```
    创建使用默认大小的输入缓冲区的缓冲字符输入流。
    
    参数
    
    in - 读者
- 方法详细信息
  - read
```
public int read()
         throws IOException
```
    读一个字符
    
    重写：
    
    read在 Reader
    
    结果
    
    字符读取，作为0到65535（ 0x00-0xffff ）范围内的整数，如果已经达到流的结尾，则为-1。
    
    异常
    
    IOException - 如果发生I / O错误
  - read
```
public int read(char[] cbuf,
                int off,
                int len)
         throws IOException
```
    将字符读入数组的一部分。
    该方法执行Reader类的相应read方法的一般合同。作为一个额外的方便，它尝试通过重复调用基础流的read方法来读取尽可能多的字符。这个迭代read继续，直到下列条件之一成立：
    - 指定的字符数已被读取，
    - 底层流的read方法返回-1 ，表示文件结尾，或
    - 底层流的ready方法返回false ，表示进一步的输入请求将阻塞。
    如果底层流上的第一个read返回-1以指示文件结束，则此方法返回-1 。否则，此方法返回实际读取的字符数。
    鼓励这个类的子类，但不是必需的，尝试以相同的方式读取尽可能多的字符。
    
    通常这种方法从这个流的字符缓冲区中获取字符，并根据需要从底层流中填充它。但是，如果缓冲区为空，则该标记无效，并且所请求的长度至少与缓冲区一样大，则该方法将直接从基础流中读取字符到给定的数组中。因此冗余BufferedReader将不会不必要地复制数据。
    Specified by:
    
    read在类别 Reader
    
    参数
    
    cbuf - 目的缓冲区
    
    off - 开始存储字符的偏移量
    
    len - 要读取的最大字符数
    
    结果
    
    读取的字符数，如果已经达到流的结尾，则为-1
    
    异常
    
    IOException - 如果发生I / O错误
  - readLine
```
public String readLine()
                throws IOException
```
    读一行文字。一行被视为由换行符（'\ n'），回车符（'\ r'）中的任何一个或随后的换行符终止。
    
    结果
    
    包含行的内容的字符串，不包括任何行终止字符，如果已达到流的末尾，则为null
    
    异常
    
    IOException - 如果发生I / O错误
    
    另请参见：
    
    Files.readAllLines(java.nio.file.Path, java.nio.charset.Charset)
  - skip
```
public long skip(long n)
          throws IOException
```
    跳过字符
    
    重写：
    
    skip在 Reader
    
    参数
    
    n - 要跳过的字符数
    
    结果
    
    实际跳过的字符数
    
    异常
    
    IllegalArgumentException - 如果 n为负数。
    
    IOException - 如果发生I / O错误
  - ready
```
public boolean ready()
              throws IOException
```
    告诉这个流是否准备好被读取。如果缓冲区不为空，或者底层字符流准备就绪，则缓冲字符流就绪。
    
    重写：
    
    ready在类别 Reader
    
    结果
    
    如果下一个read（）保证不阻止输入，则为True，否则为false。请注意，返回false并不能保证下一次读取将被阻止。
    
    异常
    
    IOException - 如果发生I / O错误
  - markSupported
```
public boolean markSupported()
```
    告诉这个流是否支持mark（）操作。
    
    重写：
    
    markSupported在 Reader
    
    结果
    
    当且仅当此流支持标记操作时才为真。
  - mark
```
public void mark(int readAheadLimit)
          throws IOException
```
    标记流中的当前位置。对reset（）的后续调用将尝试将流重新定位到此位置。
    
    重写：
    
    mark在 Reader
    
    参数
    
    readAheadLimit - 限制仍然保留标记时可能读取的字符数。在读取字符到此限制或超出之后，尝试重新设置流可能会失败。大于输入缓冲区大小的限制值将导致新的缓冲区被分配，其大小不小于limit。因此，应谨慎使用大量值。
    
    异常
    
    IllegalArgumentException - 如果 readAheadLimit < 0
    
    IOException - 如果发生I / O错误
  - reset
```
public void reset()
           throws IOException
```
    将流重置为最近的标记。
    
    重写：
    
    reset在 Reader
    
    异常
    
    IOException - 如果流未被标记，或者标记已被无效
  - close
```
public void close()
           throws IOException
```
    描述从类别： Reader复制
    
    关闭流并释放与之相关联的任何系统资源。一旦流已关闭，进一步的read（），ready（），mark（），reset（）或skip（）调用将抛出IOException。关闭以前关闭的流无效。
    
    Specified by:
    
    close在界面 Closeable
    
    Specified by:
    
    close在界面 AutoCloseable
    
    Specified by:
    
    close在 Reader
    
    异常
    
    IOException - 如果发生I / O错误
  - lines
```
public Stream<String> lines()
```
    返回一个Stream ，其元素是从这个BufferedReader读取的行。 Stream是懒惰的人群，即只读在terminal stream operation期间。
    在执行终端流操作期间，读取器不能被操作。否则，终端流操作的结果未定义。
    
    在执行终端流操作之后，不能保证读取器将处于从其读取下一个字符或行的特定位置。
    
    如果在访问底层BufferedReader时抛出BufferedReader ，它将被包裹在UncheckedIOException中，这将从导致读取的Stream方法抛出。如果在关闭的BufferedReader中调用该方法，则此方法将返回一个Stream。该流的任何操作需要在关闭之后从BufferedReader读取，将导致抛出UncheckedIOException异常。
    
    结果
    
    一个 Stream<String>提供了这个 BufferedReader的文本行
    
    从以下版本开始：
    
    1.8

Class BufferedReader

Field Summary

Fields inherited from class java.io.Reader

构造方法摘要

方法摘要

Methods inherited from class java.io.Reader

Methods inherited from class java.lang.Object

构造方法详细信息

BufferedReader

BufferedReader

方法详细信息

read

read

readLine

skip

ready

markSupported

mark

reset

close

lines