compact1, compact2, compact3

java.io

Class LineNumberReader

java.lang.Object

java.io.Reader

java.io.BufferedReader

java.io.LineNumberReader

All Implemented Interfaces:

Closeable， AutoCloseable， Readable

public class LineNumberReader
extends BufferedReader

保持线路编号的缓冲字符输入流。这类定义的方法和 getLineNumber() setLineNumber(int)用于设置和获取当前行数分别为。

默认情况下，行编号从0开始。这个数字在每一line terminator增量的数据读取，并可与电话setLineNumber(int)改变。但是请注意，这setLineNumber(int)实际上并没有改变流中的当前位置；它只改变值，将返回的getLineNumber()。

一条线是由一个换行的任何一个terminated（'\n'），回车（“R”），或一个回车紧接着换行。

从以下版本开始：

JDK1.1

Field Summary

Fields inherited from class java.io.Reader

lock

构造方法摘要

构造方法

Constructor and Description
LineNumberReader(Reader in) 创建一个新的行编号读写器，使用默认的输入缓冲区大小。
LineNumberReader(Reader in, int sz) 创建一个新的行编号读写器，将字符转换为给定大小的缓冲区。

方法摘要

Modifier and Type	Method and Description
int	getLineNumber() 获取当前的行数。
void	mark(int readAheadLimit) 标记流中的当前位置。
int	read() 读一个字符。
int	read(char[] cbuf, int off, int len) 将字符读入一个数组的一部分。
String	readLine() 读一行文本。
void	reset() 重置流到最近的标记。
void	setLineNumber(int lineNumber) 设置当前行数。
long	skip(long n) 跳过的字符。

Methods inherited from class java.io.BufferedReader

close, lines, markSupported, ready

Methods inherited from class java.io.Reader

read, read

Methods inherited from class java.lang.Object

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

Constructor Detail

LineNumberReader

public LineNumberReader(Reader in)

创建一个新的行编号读写器，使用默认的输入缓冲区大小。

参数

in -读者对象提供基础流

LineNumberReader

public LineNumberReader(Reader in,
                        int sz)

创建一个新的行编号读写器，将字符转换为给定大小的缓冲区。

参数

in -读者对象提供基础流

sz指定缓冲区大小的整数

方法详细信息

setLineNumber

public void setLineNumber(int lineNumber)

设置当前行数。

参数

lineNumber指定行号int

另请参见：

getLineNumber()

getLineNumber

public int getLineNumber()

获取当前的行数。

结果

当前行数

另请参见：

setLineNumber(int)

read

public int read()
         throws IOException

读一个字符。 Line terminators压缩为单个换行（'\n'）特征。每当一个线路终端读取的行数是递增的。

重写：

read 方法重写，继承类 BufferedReader

结果

字符读取，或-如果流的结束已达到- 1

异常

IOException如果I/O错误发生

read

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

将字符读入一个数组的一部分。每当 line terminator读取的行数是递增的。

重写：

read 方法重写，继承类 BufferedReader

参数

cbuf -目的缓冲区

off偏移，开始存储字符

len -最大字符数读

结果

读取的字节数，或-如果流的结束已达到- 1

异常

IOException如果I/O错误发生

readLine

public String readLine()
                throws IOException

读一行文本。每当 line terminator读取的行数是递增的。

重写：

readLine 方法重写，继承类 BufferedReader

结果

一个字符串包含的内容，不包括任何 line termination characters，或 null如果已到达流的末尾

异常

IOException如果I/O错误发生

另请参见：

Files.readAllLines(java.nio.file.Path, java.nio.charset.Charset)

skip

public long skip(long n)
          throws IOException

跳过的字符。

重写：

skip 方法重写，继承类 BufferedReader

参数

n -字符数跳过

结果

实际上跳过的字符数

异常

IOException如果I/O错误发生

IllegalArgumentException -如果 n是负的

mark

public void mark(int readAheadLimit)
          throws IOException

标记流中的当前位置。随后调用reset()将试图重新定位流这一点，也将复位线数适当。

重写：

mark 方法重写，继承类 BufferedReader

参数

readAheadLimit的字符数限制，可同时仍保留了马克读。读了这许多字符后，试图重置流可能会失败。

异常

IOException如果I/O错误发生

reset

public void reset()
           throws IOException

重置流到最近的标记。

重写：

reset 方法重写，继承类 BufferedReader

异常

IOException如果流不被标记，或者如果该商标已失效