|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.io.Reader java.io.BufferedReader
public class BufferedReader
从字符输入流中读取文本,缓冲各个字符,从而实现字符、数组和行的高效读取。
可以指定缓冲区的大小,或者可使用默认的大小。大多数情况下,默认值就足够大了。
通常,Reader 所作的每个读取请求都会导致对底层字符或字节流进行相应的读取请求。因此,建议用 BufferedReader 包装所有其 read() 操作可能开销很高的 Reader(如 FileReader 和 InputStreamReader)。例如,
BufferedReader in = new BufferedReader(new FileReader("foo.in"));将缓冲指定文件的输入。如果没有缓冲,则每次调用 read() 或 readLine() 都会导致从文件中读取字节,并将其转换为字符后返回,而这是极其低效的。
通过用合适的 BufferedReader 替代每个 DataInputStream,可以对将 DataInputStream 用于文字输入的程序进行本地化。
FileReader
,
InputStreamReader
字段摘要 |
---|
从类 java.io.Reader 继承的字段 |
---|
lock |
构造方法摘要 | |
---|---|
BufferedReader(Reader in)
创建一个使用默认大小输入缓冲区的缓冲字符输入流。 |
|
BufferedReader(Reader in,
int sz)
创建一个使用指定大小输入缓冲区的缓冲字符输入流。 |
方法摘要 | |
---|---|
void |
close()
关闭该流并释放与之关联的所有资源。 |
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.io.Reader 继承的方法 |
---|
read, read |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
public BufferedReader(Reader in, int sz)
in
- 一个 Readersz
- 输入缓冲区的大小
IllegalArgumentException
- 如果 sz <= 0public BufferedReader(Reader in)
in
- 一个 Reader方法详细信息 |
---|
public int read() throws IOException
Reader
中的 read
IOException
- 如果发生 I/O 错误public int read(char[] cbuf, int off, int len) throws IOException
此方法实现
类相应 Reader
方法的常规协定。另一个便捷之处在于,它将通过重复地调用底层流的 read
read
方法,尝试读取尽可能多的字符。这种迭代的 read
会一直继续下去,直到满足以下条件之一:
read
方法返回 -1
,指示文件末尾(end-of-file),或者
ready
方法返回 false
,指示将阻塞后续的输入请求。
read
返回 -1
(指示文件末尾),则此方法返回 -1
。否则此方法返回实际读取的字符数。
鼓励(但不是必须)此类的各个子类以相同的方式尝试读取尽可能多的字符。
一般来说,此方法从此流的字符缓冲区中获得字符,根据需要从底层流中填充缓冲区。但是,如果缓冲区为空、标记无效,并且所请求的长度至少与缓冲区相同,则此方法将直接从底层流中将字符读取到给定的数组中。因此多余的 BufferedReader
将不必复制数据。
Reader
中的 read
cbuf
- 目标缓冲区off
- 开始存储字符处的偏移量len
- 要读取的最大字符数
IOException
- 如果发生 I/O 错误public String readLine() throws IOException
IOException
- 如果发生 I/O 错误public long skip(long n) throws IOException
Reader
中的 skip
n
- 要跳过的字符数
IllegalArgumentException
- 如果 n
为负。
IOException
- 如果发生 I/O 错误public boolean ready() throws IOException
Reader
中的 ready
IOException
- 如果发生 I/O 错误public boolean markSupported()
Reader
中的 markSupported
public void mark(int readAheadLimit) throws IOException
Reader
中的 mark
readAheadLimit
- 在仍保留该标记的情况下,对可读取字符数量的限制。在读取达到或超过此限制的字符后,尝试重置流可能会失败。限制值大于输入缓冲区的大小将导致分配一个新缓冲区,其大小不小于该限制值。因此应该小心使用较大的值。
IllegalArgumentException
- 如果 readAheadLimit < 0
IOException
- 如果发生 I/O 错误public void reset() throws IOException
Reader
中的 reset
IOException
- 如果从未标记过该流,或者标记已失效。public void close() throws IOException
Reader
复制的描述
Closeable
中的 close
Reader
中的 close
IOException
- 如果发生 I/O 错误
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。