モジュール java.base

パッケージ java.io

クラスCharArrayReader

java.lang.Object

java.io.Reader

java.io.CharArrayReader

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

Closeable, AutoCloseable, Readable

public class CharArrayReader extends Reader

文字入力ストリームとして使用する文字バッファを実装します。

導入されたバージョン:

1.1

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected char[]	buf	文字バッファです。
protected int	count	このバッファの最後のインデックスです。
protected int	markedPos	バッファ内のマーク位置です。
protected int	pos	現在のバッファの位置です。

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

lock

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

コンストラクタ

コンストラクタ	説明
CharArrayReader(char[] buf)	指定された文字の配列からCharArrayReaderを作成します。
CharArrayReader(char[] buf, int offset, int length)	指定された文字の配列からCharArrayReaderを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
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

フィールド詳細

buf

protected char[] buf

文字バッファです。

pos

protected int pos

現在のバッファの位置です。

markedPos

protected int markedPos

バッファ内のマーク位置です。

count

protected int count

このバッファの最後のインデックスです。 このインデックス以上の有効なデータはありません。

コンストラクタの詳細

CharArrayReader

public CharArrayReader(char[] buf)

指定された文字の配列からCharArrayReaderを作成します。

パラメータ:

buf - 入力バッファ(コピーされていない)

CharArrayReader

public CharArrayReader(char[] buf, int offset, int length)

指定された文字の配列からCharArrayReaderを作成します。

結果の読者は、指定されたoffsetで読み取りを開始します。 このリーダーから読み取ることができるchar値の合計数は、lengthまたはbuf.length-offsetのいずれか小さい方になります。

パラメータ:

buf - 入力バッファ(コピーされていない)

offset - 読み込む最初の文字オフセット

length - 読み込む文字数

例外:

IllegalArgumentException - offsetが負またはbuf.lengthより大きい場合、lengthが負の場合、またはこれら2つの値の合計が負の場合。

メソッドの詳細

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

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

nパラメータは、Readerスーパー・クラスのskipメソッドが例外をスローする場合があっても、負の値にできます。 nが負の場合、このメソッドは何もせずに0を返します。

オーバーライド:

skip、クラスReader

パラメータ:

n - スキップする文字数

戻り値:

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

例外:

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

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

オーバーライド:

mark、クラスReader

パラメータ:

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

例外:

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

reset

public void reset() throws IOException

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

オーバーライド:

reset、クラスReader

例外:

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

close

public void close()

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

定義:

close、インタフェースAutoCloseable

定義:

close、インタフェースCloseable

定義:

close、クラスReader