Java java.io 类 LineNumberReader（JDK5）

所有类

java.io
类 LineNumberReader

java.lang.Object
  java.io.Reader
      java.io.BufferedReader
          java.io.LineNumberReader

所有已实现的接口：

Closeable, Readable

public class LineNumberReader
   
   
   
   
   
extends BufferedReader
   
   
   
   
   

跟踪行号的缓冲字符输入流。此类定义方法 void setLineNumber(int) 和 int getLineNumber()，它们可分别用于设置和获取当前行号。

默认情况下，行编号从 0 开始。该行号随数据读取递增，并可以通过调用 setLineNumber(int) 进行更改。但要注意，setLineNumber(int) 不会实际更改流中的当前位置；它只更改将由 getLineNumber() 返回的值。

可认为行是由换行符（'\n'）、回车符（'\r'）或回车后面紧跟换行符中的任何一个终止的。

从以下版本开始：

JDK1.1

LineNumberReader

public LineNumberReader(Reader in)

使用默认输入缓冲区的大小创建新的行编号 reader。

参数：

in - 提供基础流的 Reader 对象。

LineNumberReader

public LineNumberReader(Reader in,
                        int sz)

创建新的行编号 reader，将字符读入给定大小的缓冲区。

参数：

in - 提供基础流的 Reader 对象。

sz - 指定缓冲区大小的 int。

setLineNumber

public void setLineNumber(int lineNumber)

设置当前行号。

参数：

lineNumber - 指定行号的 int。

另请参见：

getLineNumber()

getLineNumber

public int getLineNumber()

获得当前行号。

返回：

当前行号。

另请参见：

setLineNumber(int)

read

public int read()
         throws IOException

读取单个字符。行结束符被压缩为单一新行（'\n'）字符。

覆盖：

类 BufferedReader 中的 read

返回：

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

抛出：

IOException - 如果发生 I/O 错误

read

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

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

覆盖：

类 BufferedReader 中的 read

参数：

cbuf - 目标缓冲区

off - 开始存储字符处的偏移量

len - 要读取的最多字符数

返回：

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

抛出：

IOException - 如果发生 I/O 错误

readLine

public String readLine()
                throws IOException

读取文本行。可认为行是由换行符（'\n'）、回车符（'\r'）或回车后面紧跟换行符中的任何一个终止的。

覆盖：

类 BufferedReader 中的 readLine

返回：

包含行的内容且不包括任何行结束符的字符串，如果已到达流的末尾，则返回 null

抛出：

IOException - 如果发生 I/O 错误

skip

public long skip(long n)
          throws IOException

跳过字符。

覆盖：

类 BufferedReader 中的 skip

参数：

n - 要跳过的字符数

返回：

实际跳过的字符数

抛出：

IOException - 如果发生 I/O 错误

IllegalArgumentException - 如果 n 为负