java.io
クラス CharArrayReader

java.lang.Object
  java.io.Reader
      java.io.CharArrayReader

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

Closeable, 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

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

オーバーライド:

クラス Reader 内の read

戻り値:

0 〜 65535 (0x00-0xffff) の範囲の整数としての、読み込まれた文字。ストリームの終わりに達した場合は -1

例外:

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

read

public int read(char[] b,
                int off,
                int len)
         throws IOException

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

定義:

クラス Reader 内の read

パラメータ:

b - 転送先バッファ

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

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

戻り値:

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

例外:

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

skip

public long skip(long n)
          throws IOException

文字をスキップします。スキップされた文字数を返します。

Reader スーパークラスの skip メソッドが例外をスローする場合でも、n パラメータには負の数を指定できます。n に負の数を指定した場合、このメソッドは何も行わず、0 を返します。

オーバーライド:

クラス Reader 内の skip

パラメータ:

n - スキップする文字数

戻り値:

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

例外:

IOException - ストリームが閉じている場合、または入出力エラーが発生した場合

ready

public boolean ready()
              throws IOException

ストリームが読み込み可能な状態かどうかを通知します。文字配列のリーダは、常に読み込み可能です。

オーバーライド:

クラス Reader 内の ready

戻り値:

次の read() が入力をブロックしないのが確実な場合は true、そうでない場合は false。false が返されても、次の読み込みが確実にブロックするというわけでない

例外:

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

markSupported

public boolean markSupported()

このストリームが、実行する mark() 操作をサポートするかどうかを通知します。

オーバーライド:

クラス Reader 内の markSupported

戻り値:

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

mark

public void mark(int readAheadLimit)
          throws IOException

ストリームの現在位置にマークを設定します。以降 reset() を呼び出すと、ストリームの位置がこの位置に変更されます。

オーバーライド:

クラス Reader 内の mark

パラメータ:

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

例外:

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

reset

public void reset()
           throws IOException

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

オーバーライド:

クラス Reader 内の reset

例外:

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

close

public void close()

ストリームを閉じます。

定義:

インタフェース Closeable 内の close

定義:

クラス Reader 内の close