java.io

クラス StringReader

java.lang.Object

java.io.Reader

java.io.StringReader

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

Closeable、AutoCloseable、Readable

public class StringReader
extends Reader

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

導入されたバージョン:

JDK1.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 ns) ストリーム内の指定された数の文字をスキップします。

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

read, read

クラス 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

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

定義:

read、クラス: Reader

パラメータ:

cbuf - 転送先バッファー

off - 文字の書き込み開始オフセット

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

戻り値:

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

例外:

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

skip

public long skip(long ns)
          throws IOException

ストリーム内の指定された数の文字をスキップします。スキップされた文字の数を返します。

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

文字列全体が読み込まれたかスキップされた場合、このメソッドは何も実行せずに、常に 0 を返します。

オーバーライド:

skip、クラス: Reader

パラメータ:

ns - スキップする文字数

戻り値:

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

例外:

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 が負の値の場合

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

reset

public void reset()
           throws IOException

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

オーバーライド:

reset、クラス: Reader

例外:

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

close

public void close()

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

定義:

close、インタフェース: Closeable

定義:

close、インタフェース: AutoCloseable

定義:

close、クラス: Reader