JavaTM Platform
Standard Ed. 6

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 値の総数は、lengthbuf.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
文字をスキップします。スキップした文字数を返します。

n パラメータには、Reader スーパークラスの skip メソッドが例外をスローする場合であっても、負を設定できます。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()
ストリームを閉じて、それに関連するすべてのシステムリソースを解放します。ストリームを閉じたあとに、さらに read()、ready()、mark()、reset()、または skip() を呼び出すと、IOException がスローされます。すでに閉じられているストリームを閉じても、何の影響もありません。

定義:
インタフェース Closeable 内の close
定義:
クラス Reader 内の close

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。