Java java.io 类 LineNumberInputStream（JDK5）

所有类

java.io
类 LineNumberInputStream

java.lang.Object
  java.io.InputStream
      java.io.FilterInputStream
          java.io.LineNumberInputStream

所有已实现的接口：

Closeable

@Deprecated
public class LineNumberInputStream
   
   
   
   
   
extends FilterInputStream
   
   
   
   
   

此类是一个输入流过滤器，它提供跟踪当前行号的附加功能。

行是以回车符号 ('\r')、新行字符 ('\n') 或回车符号后面紧跟换行字符结尾的字节序列。在所有这三种情况下，都以单个新行字符形式返回行终止字符。

行号以 0 开头，并在 read 返回新行字符时递增 1。

从以下版本开始：

JDK1.0

另请参见：

LineNumberReader

LineNumberInputStream

public LineNumberInputStream(InputStream in)

已过时。 

构造从指定输入流读取其输入的新行号输入流。

参数：

in - 基础输入流。

read

public int read()
         throws IOException

已过时。 

从此输入流读取下一个数据字节。返回 0 到 255 范围内的 int 字节值。如果因流的末尾已到达而没有可用的字节，则返回值 -1。在输入数据可用、检测到流的末尾或者抛出异常前，此方法一直阻塞。

LineNumberInputStream 的 read 方法调用基础输入流的 read 方法。它检查输入中的回车和新行字符，并相应地修改当前行号。回车符或后跟新行字符的回车两者都可转换为单个新行字符。

覆盖：

类 FilterInputStream 中的 read

返回：

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

抛出：

IOException - 如果发生 I/O 错误。

另请参见：

FilterInputStream.in, getLineNumber()

read

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

已过时。 

将最多 len 个数据字节从此输入流读入字节数组。在某个输入可用前，此方法一直阻塞。

LineNumberInputStream 的 read 方法重复调用 0 参数的 read 方法来填充字节数组。

覆盖：

类 FilterInputStream 中的 read

参数：

b - 读入数据的缓冲区。

off - 数据的初始偏移量。

len - 读取的最大字节数。

返回：

读入缓冲区的总字节数，如果由于已到达此流的末尾而不再有数据，则返回 -1。

抛出：

IOException - 如果发生 I/O 错误。

另请参见：

read()

skip

public long skip(long n)
          throws IOException

已过时。 

跳过和放弃此输入流中的 n 个数据字节。出于各种原因，该 skip 方法跳过某些较小的字节数（可能是 0）后结束。返回跳过的实际字节数。如果 n 为负，则不跳过任何字节。

LineNumberInputStream 的 skip 方法创建字节数组，然后重复向其读入，直到读够 n 个字节或已到达流的末尾为止。

覆盖：

类 FilterInputStream 中的 skip

参数：

n - 要跳过的字节数。

返回：

跳过的实际字节数。

抛出：

IOException - 如果发生 I/O 错误。

另请参见：

FilterInputStream.in

setLineNumber

public void setLineNumber(int lineNumber)

已过时。 

将行号设置为指定参数。

参数：

lineNumber - 新行号。

另请参见：

getLineNumber()

getLineNumber

public int getLineNumber()

已过时。 

返回当前行号。

返回：

当前行号。

另请参见：

setLineNumber(int)

available

public int available()
              throws IOException

已过时。 

无阻塞情况下返回可以从此输入流中读取的字节数。

注意，如果基础输入流能够在无阻塞情况下提供 k 个输入字符，则 LineNumberInputStream 可以保证在无阻塞情况下只提供 k/2 个字符，因为基础输入流中的 k 个字符可能由 k/2 个 '\r' 和 '\n' 对组成，这些对只能转换为 k/2 '\n' 个字符。

覆盖：

类 FilterInputStream 中的 available

返回：

无阻塞情况下可以从此输入流读取的字节数。

抛出：

IOException - 如果发生 I/O 错误。

另请参见：

FilterInputStream.in

mark

public void mark(int readlimit)

已过时。 

在此输入流中标记当前的位置。对 reset 方法的后续调用会在最后标记的位置重新定位此流，以使后续读取重新读取相同的字节。

LineNumberInputStream 的 mark 方法会记住 private 变量中的当前行号，然后调用基础输入流的 mark 方法。

覆盖：

类 FilterInputStream 中的 mark

参数：

readlimit - 在标记位置失效前可以读取字节的最大限制。

另请参见：

FilterInputStream.in, reset()