compact1, compact2, compact3

java.io

Class PushbackInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.io.PushbackInputStream

All Implemented Interfaces:

Closeable， AutoCloseable

public class PushbackInputStream
extends FilterInputStream

一个 PushbackInputStream添加功能到另一个输入流，即能够“推”或“未读”一个字节。这是非常有用的，它的代码片段阅读，是由一个特定的字节值分隔符的数据字节的数量方便情况；阅读后终止的字节代码片段可以“未读”，这样在输入流中的下一个读操作将重读字节被推了回来。例如，代表构成标识符的字符的字节可以由一个表示操作符的字节终止；一种方法，其工作是只读一个标识符，直到它看到操作符，然后再将操作人员重新读取。

从以下版本开始：

JDK1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	buf 回退缓冲区。
protected int	pos 位置在后推缓冲，下一个字节将被读取。

Fields inherited from class java.io.FilterInputStream

in

构造方法摘要

构造方法

Constructor and Description
PushbackInputStream(InputStream in) 创建一个 PushbackInputStream和保存它的参数，输入流 in，供以后使用。
PushbackInputStream(InputStream in, int size) 创建一个指定的缓冲区 PushbackInputStream size一推，并保存它的参数，输入流 in，供以后使用。

方法摘要

Modifier and Type	Method and Description
int	available() 返回一个可以从这个输入流读取（或跳过）的字节数的估计值，而不阻塞该输入流的下一个方法的调用。
void	close() 关闭此输入流并释放与流关联的任何系统资源。
void	mark(int readlimit) 标记此输入流中的当前位置。
boolean	markSupported() 如果输入流的支持 mark和 reset方法，它不。
int	read() 从这个输入流读取下一个数据字节。
int	read(byte[] b, int off, int len) 读到 len字节从输入流到字节数组数据。
void	reset() 重新定位该流在时间的 mark方法的位置上呼吁这个输入流。
long	skip(long n) 跳过并丢弃 n字节从输入流中的数据。
void	unread(byte[] b) 将字节数组复制到缓冲区的推前。
void	unread(byte[] b, int off, int len) 把后面的字节数组的一部分复制到缓冲区的推前。
void	unread(int b) 掀开一个字节复制到缓冲区的推前。

Methods inherited from class java.io.FilterInputStream

read

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

buf

protected byte[] buf

回退缓冲区。

从以下版本开始：

JDK1.1

pos

protected int pos

位置在后推缓冲，下一个字节将被读取。当缓冲区是空的， pos等于 buf.length；当缓冲区已满， pos等于零。

从以下版本开始：

JDK1.1

Constructor Detail

PushbackInputStream

public PushbackInputStream(InputStream in,
                           int size)

创建一个指定的缓冲区 PushbackInputStream size一推，并保存它的参数，输入流 in，供以后使用。最初，没有推字节（现场 pushBack初始化为 -1）。

参数

in -输入流的字节将被读取。

size -回退缓冲区的大小。

异常

如果 size <= 0 IllegalArgumentException

从以下版本开始：

JDK1.1

PushbackInputStream

public PushbackInputStream(InputStream in)

创建一个 PushbackInputStream和保存它的参数，输入流 in，供以后使用。最初，没有推字节（现场 pushBack初始化为 -1）。

参数

in -输入流的字节将被读取。

方法详细信息

read

public int read()
         throws IOException

从这个输入流读取下一个数据字节。字节的值在范围 0一 int到 255返回。如果没有可用的字节，因为已到达流的末尾，则返回值 -1。此方法块，直到输入数据可用，流的结束被检测到，或抛出异常。

此方法返回最近推的字节，如果有一个，否则调用其数据输入流和返回任何值，方法返回read方法。

重写：

read 方法重写，继承类 FilterInputStream

结果

下一个数据字节，或 -1如果已到达流的末尾。

异常

IOException如果输入流被调用其 close()方法关闭，或发生I/O错误。

另请参见：

InputStream.read()

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

读到 len从输入流到字节数组数据字节。该方法首先读取任何推字节；之后，如果少于 len字节被读取然后读取数据输入流。如果 len不为零，法块直到至少1字节的输入是有效的；否则，没有字节读取和 0返回。

重写：

read 方法重写，继承类 FilterInputStream

参数

b -缓冲区中读取数据。

off -开始抵消目标数组 b

len -的最大字节数读。

结果

读入缓冲的字节总数，或 -1如果没有更多的数据，因为已到达流的末尾。

异常

如果是 null b NullPointerException。

IndexOutOfBoundsException -如果 off是负的， len是负的，或 len大于 b.length - off

IOException如果输入流被调用其 close()方法关闭，或发生I/O错误。

另请参见：

InputStream.read(byte[], int, int)

unread

public void unread(int b)
            throws IOException

掀开一个字节复制到缓冲区的推前。此方法返回后，下一个要读取的字节的值将 (byte)b。

参数

b - int值的低位字节是被推了回来。

异常

IOException -如果没有足够的空间在后推缓冲字节输入流，或被调用其 close()方法封闭。

unread

public void unread(byte[] b,
                   int off,
                   int len)
            throws IOException

把后面的字节数组的一部分复制到缓冲区的推前。此方法返回后，下一个要读取的字节的值将 b[off]，字节后，将有价值 b[off+1]，等等。

参数

b -推后的字节数组。

off的起始偏移量的数据。

len -字节数推回去。

异常

IOException -如果没有足够的空间在后推缓冲区指定的字节数，或输入流被调用方法的 close()封闭。

从以下版本开始：

JDK1.1

unread

public void unread(byte[] b)
            throws IOException

将字节数组复制到缓冲区的推前。此方法返回后，下一个要读取的字节的值将 b[0]，字节后，将有价值 b[1]，等等。

参数

b -推后的字节数组

异常

IOException -如果没有足够的空间在后推缓冲区指定的字节数，或输入流被调用方法的 close()封闭。

从以下版本开始：

JDK1.1

available

public int available()
              throws IOException

返回一个可以从这个输入流读取（或跳过）的字节数的估计值，而不阻塞该输入流的下一个方法的调用。下一个调用可能是同一个线程或另一个线程。一个单一的读或跳过这许多字节将不会阻止，但可以读取或跳过更少的字节数。

该方法返回的已推后，返回的值available字节数的总和。

重写：

available 方法重写，继承类 FilterInputStream

结果

可以从输入流中读取（或跳过）的字节数，而不阻塞。

异常

IOException如果输入流被调用其 close()方法关闭，或发生I/O错误。

另请参见：

FilterInputStream.in， InputStream.available()

skip

public long skip(long n)
          throws IOException

跳过并丢弃 n字节从输入流中的数据。 skip方法的可能，因为种种原因，最终跳过一些较小的字节数，可能为零。如果 n是负的，没有跳过的字节。

在后推缓冲字节PushbackInputStream第一跳skip方法，如果任何。然后调用底层输入流的skip方法如果需要跳过的字节。跳过的字节数实际返回。

重写：

skip 方法重写，继承类 FilterInputStream

参数

n -字节数被跳过。

结果

跳过的实际字节数。

异常

IOException如果流不支持查找，或流已经通过调用其 close()方法关闭，或发生I/O错误。

从以下版本开始：

一点二

另请参见：

FilterInputStream.in， InputStream.skip(long n)

markSupported

public boolean markSupported()

如果输入流的支持 mark和 reset方法，它不。

重写：

markSupported 方法重写，继承类 FilterInputStream

结果

false，由于这类不支持 mark和 reset方法。

另请参见：

InputStream.mark(int)， InputStream.reset()

mark

public void mark(int readlimit)

标记此输入流中的当前位置。

对PushbackInputStream的mark方法不。

重写：

mark 方法重写，继承类 FilterInputStream

参数

readlimit -字节可以在标记位置无效阅读最大限度。

另请参见：

InputStream.reset()

reset

public void reset()
           throws IOException

重新定位该流在时间的 mark方法的位置上呼吁这个输入流。

类的方法PushbackInputStream reset仅仅抛出一个IOException。

重写：

reset 方法重写，继承类 FilterInputStream

异常

如果这个方法被调用 IOException。

另请参见：

InputStream.mark(int)， IOException

close

public void close()
           throws IOException

关闭此输入流并释放与流关联的任何系统资源。一旦流已经关闭，进一步read()，unread()，available()，reset()，或skip()调用会抛出IOException。关闭先前关闭的流没有影响。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

重写：

close 方法重写，继承类 FilterInputStream

异常

IOException如果I/O错误发生。

另请参见：

FilterInputStream.in