java.io
クラス LineNumberReader

java.lang.Object
  |
  +--java.io.Reader
        |
        +--java.io.BufferedReader
              |
              +--java.io.LineNumberReader

public class LineNumberReader

extends BufferedReader

行番号を追跡して管理する、バッファリングされた文字入力ストリームです。このクラスには、現在の行番号を設定する void setLineNumber(int) メソッドと、現在の行番号を取得する int getLineNumber() メソッドが定義されています。

デフォルトでは、行番号は 0 から始まります。行番号は、データが読み込まれるたびに増分します。行番号を変更するときは、setLineNumber(int) を呼び出します。ただし、setLineNumber(int) は、ストリーム内の現在位置を実際に変更するのではなく、getLineNumber() から返される値を変更するだけです。

1 行の終端は、改行 ('¥n') か、復帰 ('¥r')、または復行とそれに続く改行のどれかで認識されます。

導入されたバージョン:

JDK1.1

フィールドの概要

クラス java.io.Reader から継承したフィールド

lock

コンストラクタの概要

LineNumberReader(Reader in)
デフォルトの入力バッファサイズを使用して、行番号付きリーダを新しく作成します。

LineNumberReader(Reader in, int sz)
指定されたサイズのバッファに文字を読み込む、行番号付きリーダを新しく作成します

メソッドの概要

int	getLineNumber() 行番号の現在値を取得します。
void	mark(int readAheadLimit) ストリームの現在位置にマークを設定します。
int	read() 1 個の文字を読み込みます。
int	read(char[] cbuf, int off, int len) 配列の一部に文字を読み込みます。
String	readLine() 1 行のテキストを読み込みます。
void	reset() ストリームを、もっとも新しいマーク位置にリセットします。
void	setLineNumber(int lineNumber) 現在の行番号を設定します。
long	skip(long n) 文字をスキップします。

クラス java.io.BufferedReader から継承したメソッド

close, markSupported, ready

クラス java.io.Reader から継承したメソッド

read

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

LineNumberReader

public LineNumberReader(Reader in)

デフォルトの入力バッファサイズを使用して、行番号付きリーダを新しく作成します。

パラメータ:

in - 基本となるストリームを提供する Reader オブジェクト

LineNumberReader

public LineNumberReader(Reader in,
                        int sz)

指定されたサイズのバッファに文字を読み込む、行番号付きリーダを新しく作成します

パラメータ:

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

1 個の文字を読み込みます。行の終端は 1 個の改行文字 ('¥n') に変換されます。

オーバーライド:

クラス BufferedReader 内の read

戻り値:

読み込まれた文字。ストリームの終わりに達した場合は -1

例外:

IOException - 入出力エラーが発生した場合

read

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

配列の一部に文字を読み込みます。

オーバーライド:

クラス BufferedReader 内の read

パラメータ:

cbuf - 転送先バッファ

off - 文字の格納開始オフセット

len - 読み込む文字の最大数

戻り値:

読み込まれた文字数。ストリームの終わりに達している場合は -1

例外:

IOException - 入出力エラーが発生した場合

readLine

public String readLine()
                throws IOException

1 行のテキストを読み込みます。1 行の終端は、改行 ('¥n') か、復帰 ('¥r')、または復行とそれに続く改行のどれかで認識されます。

オーバーライド:

クラス BufferedReader 内の readLine

戻り値:

行の内容を含む文字列、ただし行の終端文字は含めない。ストリームの終わりに達している場合は null

例外:

IOException - 入出力エラーが発生した場合

skip

public long skip(long n)
          throws IOException

文字をスキップします。

オーバーライド:

クラス BufferedReader 内の skip

パラメータ:

n - スキップする文字数

戻り値:

実際にスキップした文字数

例外:

IOException - 入出力エラーが発生した場合

mark

public void mark(int readAheadLimit)
          throws IOException

ストリームの現在位置にマークを設定します。これに続いて reset() を呼び出すと、ストリームを現在のマーク位置にリセットし、それに合わせて行番号をリセットします。

オーバーライド:

クラス BufferedReader 内の mark

パラメータ:

readAheadLimit - マークを保持しながら読み込むことができる文字数の上限。この数の文字を読み込んだあとでストリームをリセットしようとすると失敗する場合がある

例外:

IOException - 入出力エラーが発生した場合

reset

public void reset()
           throws IOException

ストリームを、もっとも新しいマーク位置にリセットします。

オーバーライド:

クラス BufferedReader 内の reset

例外:

IOException - ストリームにマークが設定されていなかった場合、またはマークが無効になっていた場合