java.lang.Object
java.io.Reader
java.io.FilterReader
- すべての実装されたインタフェース:
Closeable
,AutoCloseable
,Readable
- 直系の既知のサブクラス:
PushbackReader
public abstract class FilterReader extends Reader
フィルタ処理された文字列ストリームを読み込むための抽象クラスです。 抽象クラス
FilterReader
そのものが、格納されているストリームにすべての要求を渡すデフォルトのメソッドを提供します。 FilterReader
のサブクラスは、これらのメソッドの一部をオーバーライドし、追加のメソッドやフィールドを提供することもできます。 - 導入されたバージョン:
- 1.1
-
フィールドのサマリー
フィールド -
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明void
close()
ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。void
mark
(int readAheadLimit) ストリームの現在位置にマークを設定します。boolean
このストリームがmark()オペレーションをサポートするかどうかを判定します。int
read()
単一の文字を読み込みます。int
read
(char[] cbuf, int off, int len) 配列の一部に文字を読み込みます。boolean
ready()
このストリームが読込み可能かどうかを判定します。void
reset()
ストリームをリセットします。long
skip
(long n) 文字をスキップします。クラスjava.io.Readerで宣言されたメソッド
nullReader, read, read, transferTo
-
フィールド詳細
-
in
protected Reader inベースとなる文字入力ストリームです。
-
-
コンストラクタの詳細
-
FilterReader
protected FilterReader(Reader in) フィルタ処理された新しいリーダーを作成します。- パラメータ:
in
- ベースとなるストリームを提供するReaderオブジェクト。- 例外:
NullPointerException
-in
がnull
である場合
-
-
メソッドの詳細
-
read
public int read() throws IOException単一の文字を読み込みます。- オーバーライド:
read
、クラスReader
- 戻り値:
- 0から65535 (
0x00-0xffff
)の範囲の整数として読み取られる文字、またはストリームの終わりに達した場合は-1を読み取る文字 - 例外:
IOException
- 入出力エラーが発生した場合
-
read
public int read(char[] cbuf, int off, int len) throws IOException 配列の一部に文字を読み込みます。 このメソッドは入力の一部が有効になるか、入出力エラーが発生するか、あるいはストリームの終わりに達するまでブロックします。len
が0の場合、文字は読み取られず、0
が返されます。そうしないと、少なくとも1文字の読取りが試行されます。 ストリームが終了しているため、使用できる文字がない場合、値-1
が返されます。そうしないと、少なくとも1つの文字が読み取られ、cbuf
に格納されます。- 定義:
read
、クラスReader
- パラメータ:
cbuf
- 転送先バッファoff
- 文字の格納開始オフセットlen
- 読み込む文字の最大数- 戻り値:
- 読み込まれた文字数。ストリームの終わりに達した場合は -1
- 例外:
IndexOutOfBoundsException
-off
が負、len
が負、またはlen
がcbuf.length - off
より大きい場合IOException
- 入出力エラーが発生した場合
-
skip
public long skip(long n) throws IOException 文字をスキップします。 このメソッドは、文字が読み込まれるか、入出力エラーが発生するか、あるいはストリームの終わりに達するまでブロックします。 このメソッドを呼び出す前にストリームがすでに終了している場合は、文字はスキップされず、ゼロが返されます。- オーバーライド:
skip
、クラスReader
- パラメータ:
n
- スキップする文字数- 戻り値:
- 実際にスキップした文字数
- 例外:
IllegalArgumentException
-n
が負の値で、含まれるReader
のskip
メソッドがネガティブ・パラメータに対してIllegalArgumentExceptionをスローする場合IOException
- 入出力エラーが発生した場合
-
ready
public boolean ready() throws IOExceptionこのストリームが読込み可能かどうかを判定します。- オーバーライド:
ready
、クラスReader
- 戻り値:
- 次のread()が入力をブロックしないことが確実な場合はtrue、そうでない場合はfalse。 falseが返されても、次の読込みが確実にブロックするというわけでない。
- 例外:
IOException
- 入出力エラーが発生した場合
-
markSupported
public boolean markSupported()このストリームがmark()オペレーションをサポートするかどうかを判定します。- オーバーライド:
markSupported
、クラスReader
- 戻り値:
- このストリームがmarkオペレーションをサポートする場合に限りtrue。
-
mark
public void mark(int readAheadLimit) throws IOException ストリームの現在位置にマークを設定します。- オーバーライド:
mark
、クラスReader
- パラメータ:
readAheadLimit
- マークを保持しながら読み込むことができる文字数の上限。 この数の文字を読み込んだあとでストリームをリセットしようとすると失敗する場合がある。- 例外:
IOException
- 入出力エラーが発生した場合
-
reset
public void reset() throws IOExceptionストリームをリセットします。- オーバーライド:
reset
、クラスReader
- 例外:
IOException
- 入出力エラーが発生した場合
-
close
public void close() throws IOException次のクラスからコピーされた説明:Reader
ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 ストリームが閉じられたあとにread()、ready()、mark()、reset()、またはskip()を呼び出すと、IOExceptionがスローされます。 すでに閉じられているストリームを閉じても、何の影響もありません。- 定義:
close
、インタフェースAutoCloseable
- 定義:
close
、インタフェースCloseable
- 定義:
close
、クラスReader
- 例外:
IOException
- 入出力エラーが発生した場合
-