java.io

クラス CharArrayReader

java.lang.Object

java.io.Reader

java.io.CharArrayReader

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

Closeable、AutoCloseable、Readable

public class CharArrayReader
extends Reader

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

導入されたバージョン:

JDK1.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[] b, int off, int len) 配列の一部に文字を読み込みます。
boolean	ready() このストリームが読み込み可能かどうかを判定します。
void	reset() 直前のマーク位置にストリームをリセットします。マークが設定されていない場合は、先頭位置にリセットします。
long	skip(long n) 文字をスキップします。

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

read, read

クラス 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[] b,
       int off,
       int len)
         throws IOException

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

定義:

read、クラス: Reader

パラメータ:

b - 転送先バッファー

off - 文字の格納開始オフセット

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

戻り値:

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

例外:

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、インタフェース: Closeable

定義:

close、インタフェース: AutoCloseable

定義:

close、クラス: Reader