モジュール java.base

パッケージ java.io

クラスStringReader

java.lang.Object

java.io.Reader

java.io.StringReader

すべての実装されたインタフェース:

Closeable, AutoCloseable, Readable

public class StringReader extends Reader

ソースが文字列の文字ストリームです。

導入されたバージョン:

1.1

フィールドのサマリー

クラスjava.io.Readerで宣言されたフィールド

lock

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
StringReader(String s)	新しい文字列リーダーを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	close()	ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。
void	mark(int readAheadLimit)	ストリームの現在位置にマークを設定します。
boolean	markSupported()	このストリームが、実行する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

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

StringReader

public StringReader(String s)

新しい文字列リーダーを作成します。

パラメータ:

s - 文字ストリームを提供する文字列。

メソッドの詳細

read

public int read() throws IOException

単一の文字を読み込みます。

オーバーライド:

read、クラスReader

戻り値:

読み込まれた文字。ストリームの終わりに達した場合は -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

文字をスキップします。 このメソッドを呼び出す前にストリームがすでに終了している場合は、文字はスキップされず、ゼロが返されます。

nパラメータは、Readerスーパー・クラスのskipメソッドが例外をスローする場合があっても、負の値にできます。 nが負の値の場合、ストリームは後方にスキップされます。 負の戻り値は、後ろへスキップすることを示します。 文字列の先頭を超えて後ろへスキップすることはできません。

文字列全体を読み取りまたはスキップした場合、このメソッドは効果がなく、常に0を返します。

オーバーライド:

skip、クラスReader

パラメータ:

n - スキップする文字数

戻り値:

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

例外:

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

ready

public boolean ready() throws IOException

このストリームが読込み可能かどうかを判定します。

オーバーライド:

ready、クラスReader

戻り値:

次のread()が入力をブロックしないことを保証できる場合はtrue

例外:

IOException - ストリームが閉じられた場合

markSupported

public boolean markSupported()

このストリームが、実行するmark()オペレーションをサポートするかどうかを通知します。

オーバーライド:

markSupported、クラスReader

戻り値:

このストリームがmarkオペレーションをサポートする場合に限りtrue。

mark

public void mark(int readAheadLimit) throws IOException

ストリームの現在位置にマークを設定します。 以降のreset()の呼出しでは、ストリームはこの位置に再配置されます。

オーバーライド:

mark、クラスReader

パラメータ:

readAheadLimit - マークを保持しながら読み込むことができる文字数の上限。 文字列からストリームに入力されるので、実際の上限はない。そのため、この引数は負の値であってはならないが、そうでない場合は無視される。

例外:

IllegalArgumentException - readAheadLimit < 0の場合

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

reset

public void reset() throws IOException

直前のマーク位置にストリームをリセットします。マークが設定されていない場合は、文字列の先頭にリセットします。

オーバーライド:

reset、クラスReader

例外:

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

close

public void close()

ストリームを閉じて、それに関連するすべてのシステム・リソースを解放します。 ストリームが閉じられたあとにread()、ready()、mark()、またはreset()を呼び出すと、IOExceptionがスローされます。 すでに閉じられているストリームを閉じても、何の影響もありません。 このメソッドは、リーダーで別のスレッドがブロックされている間はブロックされます。

定義:

close、インタフェースAutoCloseable

定義:

close、インタフェースCloseable

定義:

close、クラスReader