java.lang.Object
java.io.Reader
java.io.FilterReader
java.io.PushbackReader
- すべての実装されたインタフェース:
Closeable
,AutoCloseable
,Readable
public class PushbackReader extends FilterReader
文字をストリームにプッシュ・バックできる文字ストリーム・リーダーです。
- 導入されたバージョン:
- 1.1
-
フィールドのサマリー
クラスjava.io.FilterReaderで宣言されたフィールド
in
-
コンストラクタのサマリー
コンストラクタコンストラクタ説明PushbackReader
(Reader in) 1文字分のプッシュバック・バッファを持つ、新しいプッシュバック・リーダーを作成します。PushbackReader
(Reader in, int size) 指定されたサイズのプッシュバック・バッファを持つ、新しいプッシュバック・リーダーを作成します。 -
メソッドのサマリー
修飾子と型メソッド説明void
close()
ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。void
mark
(int readAheadLimit) ストリームの現在位置にマークを設定します。boolean
このストリームがmark()オペレーションをサポートするかどうか、サポートしないのはどれなのかを調べます。int
read()
単一の文字を読み込みます。boolean
ready()
このストリームが読込み可能かどうかを判定します。void
reset()
ストリームをリセットします。void
unread
(char[] cbuf) プッシュバック・バッファの先頭に文字配列をコピーすることによって、文字配列をプッシュ・バックします。void
unread
(char[] cbuf, int off, int len) プッシュバック・バッファの先頭に文字配列の一部をコピーすることによって、それらの文字をプッシュ・バックします。void
unread
(int c) プッシュバック・バッファの先頭に1文字をコピーすることによって、その文字をプッシュ・バックします。クラスjava.io.FilterReaderで宣言されたメソッド
read, skip
クラスjava.io.Readerで宣言されたメソッド
nullReader, read, read, transferTo
-
コンストラクタの詳細
-
PushbackReader
public PushbackReader(Reader in, int size) 指定されたサイズのプッシュバック・バッファを持つ、新しいプッシュバック・リーダーを作成します。- パラメータ:
in
- 文字の読込み元のリーダーsize
- プッシュバック・バッファのサイズ- 例外:
IllegalArgumentException
-size <= 0
の場合
-
PushbackReader
public PushbackReader(Reader in) 1文字分のプッシュバック・バッファを持つ、新しいプッシュバック・リーダーを作成します。- パラメータ:
in
- 文字の読込み元のリーダー
-
-
メソッドの詳細
-
read
public int read() throws IOException単一の文字を読み込みます。- オーバーライド:
read
、クラスFilterReader
- 戻り値:
- 読み込まれた文字。ストリームの終わりに達した場合は -1
- 例外:
IOException
- 入出力エラーが発生した場合
-
unread
public void unread(int c) throws IOException プッシュバック・バッファの先頭に1文字をコピーすることによって、その文字をプッシュ・バックします。 このメソッドが復帰すると、次に読み込まれる文字は値(char)c
を持ちます。- パラメータ:
c
- プッシュ・バックされる文字を表すint値- 例外:
IOException
- ブッシュバック・バッファがいっぱいの場合、またはほかの入出力エラーが発生した場合
-
unread
public void unread(char[] cbuf, int off, int len) throws IOException プッシュバック・バッファの先頭に文字配列の一部をコピーすることによって、それらの文字をプッシュ・バックします。 このメソッドが復帰すると、次に読み込まれる文字は値cbuf[off]
を持ち、その次の文字は値cbuf[off+1]
を持ちます。それ以降も同様に続きます。- パラメータ:
cbuf
- 文字配列off
- 文字のプッシュ・バック開始オフセットlen
- プッシュ・バックする文字数- 例外:
IOException
- プッシュバック・バッファに十分なスペースがない場合、またはほかの入出力エラーが発生した場合
-
unread
public void unread(char[] cbuf) throws IOException プッシュバック・バッファの先頭に文字配列をコピーすることによって、文字配列をプッシュ・バックします。 このメソッドが復帰すると、次に読み込まれる文字は値cbuf[0]
を持ち、その次の文字は値cbuf[1]
を持ちます。それ以降も同様に続きます。- パラメータ:
cbuf
- プッシュ・バックする文字配列- 例外:
IOException
- プッシュバック・バッファに十分なスペースがない場合、またはほかの入出力エラーが発生した場合
-
ready
public boolean ready() throws IOExceptionこのストリームが読込み可能かどうかを判定します。- オーバーライド:
ready
、クラスFilterReader
- 戻り値:
- 次のread()が入力をブロックしないことが確実な場合はtrue、そうでない場合はfalse。 falseが返されても、次の読込みが確実にブロックするというわけでない。
- 例外:
IOException
- 入出力エラーが発生した場合
-
mark
public void mark(int readAheadLimit) throws IOException ストリームの現在位置にマークを設定します。PushbackReader
クラスのmark
は常に例外をスローします。- オーバーライド:
mark
、クラスFilterReader
- パラメータ:
readAheadLimit
- マークを保持しながら読み込むことができる文字数の上限。 この数の文字を読み込んだあとでストリームをリセットしようとすると失敗する場合がある。- 例外:
IOException
- markメソッドはサポートされていないので、常にスローされる
-
reset
public void reset() throws IOExceptionストリームをリセットします。reset
のPushbackReader
メソッドは常に例外をスローします。- オーバーライド:
reset
、クラスFilterReader
- 例外:
IOException
- resetメソッドはサポートされていないので、常にスローされる
-
markSupported
public boolean markSupported()このストリームがmark()オペレーションをサポートするかどうか、サポートしないのはどれなのかを調べます。- オーバーライド:
markSupported
、クラスFilterReader
- 戻り値:
- このストリームがmarkオペレーションをサポートする場合に限りtrue。
-
close
public void close() throws IOExceptionストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 ストリームを閉じたあとに、さらにread()、unread()、ready()、またはskip()を呼び出すと、IOExceptionがスローされます。 すでに閉じられているストリームを閉じても、何の影響もありません。 このメソッドは、リーダーで別のスレッドがブロックされている間はブロックされます。- 定義:
close
、インタフェースAutoCloseable
- 定義:
close
、インタフェースCloseable
- 定義:
close
、クラスReader
- 例外:
IOException
- 入出力エラーが発生した場合
-