Java java.io 类 PushbackReader（JDK5）

所有类

java.io
类 PushbackReader

java.lang.Object
  java.io.Reader
      java.io.FilterReader
          java.io.PushbackReader

所有已实现的接口：

Closeable, Readable

public class PushbackReader
   
   
   
   
   
extends FilterReader
   
   
   
   
   

允许将字符推回到流的字符流 reader。

从以下版本开始：

JDK1.1

PushbackReader

public PushbackReader(Reader in,
                      int size)

创建具有给定大小推回缓冲区的新推回 reader。

参数：

in - 将从中读取字符的 reader

size - 推回缓冲区的大小

抛出：

IllegalArgumentException - 如果 size <= 0

PushbackReader

public PushbackReader(Reader in)

创建具有单字符推回缓冲区的新推回 reader。

参数：

in - 将从中读取字符的 reader

read

public int read()
         throws IOException

读取单个字符。

覆盖：

类 FilterReader 中的 read

返回：

读取的字符，如果已到达流的末尾，则返回 -1

抛出：

IOException - 如果发生 I/O 错误

read

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

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

覆盖：

类 FilterReader 中的 read

参数：

cbuf - 目标缓冲区

off - 开始写入字符处的偏移量

len - 要读取的最多字符数

返回：

读取的字符数，如果已到达流的末尾，则返回 -1

抛出：

IOException - 如果发生 I/O 错误

unread

public void unread(int c)
            throws IOException

推回单个字符。

参数：

c - 要推回的字符

抛出：

IOException - 如果推回缓冲区已满，或者发生一些其他 I/O 错误

unread

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

推回字符数组的某一部分，方法是将其复制到推回缓冲区的前面。在返回此方法后，要读取的下一个字符将具有值 cbuf[off]，其后的字节将具有值 cbuf[off+1]，依次类推。

参数：

cbuf - 字符数组

off - 要推回的第一个字符的偏移量

len - 要推回的字符数

抛出：

IOException - 如果推回缓冲区中没有足够的空间，或者发生一些其他 I/O 错误

unread

public void unread(char[] cbuf)
            throws IOException

推回一个字符数组，方法是将其复制到推回缓冲区前面。在返回此方法后，要读取的下一个字符将具有值 cbuf[0]，其后的字节将具有值 cbuf[1]，依次类推。

参数：

cbuf - 要推回的字符数组

抛出：

IOException - 如果推回缓冲区中没有足够的空间，或者发生一些其他 I/O 错误

ready

public boolean ready()
              throws IOException

判断是否准备读取此流。

覆盖：

类 FilterReader 中的 ready

返回：

如果保证下一个 read() 不阻塞输入，则返回 True，否则返回 false。注意，返回 false 并不保证阻塞下一次读取。

抛出：

IOException - 如果发生 I/O 错误