java.lang.Object
java.io.Writer
java.io.CharArrayWriter
- すべての実装されたインタフェース:
- Closeable,- Flushable,- Appendable,- AutoCloseable
public class CharArrayWriter extends Writer
このクラスは、ライターとして使用できる文字バッファを実装します。 ストリームに文字が書き込まれるに従って、バッファは自動的に大きくなります。 toCharArray()やtoString()を使ってデータを取り出すことができます。 
 
ノート: このクラスでclose()を呼び出しても、何も変化はありません。ストリームを閉じたあとにこのクラスのメソッドを呼び出しても、IOExceptionは生成されません。
- 導入されたバージョン:
- 1.1
- 
フィールドのサマリーフィールド
- 
コンストラクタのサマリーコンストラクタコンストラクタ説明CharArrayWriterを新しく作成します。CharArrayWriter(int initialSize) 指定された初期サイズでCharArrayWriterを新しく作成します。
- 
メソッドのサマリー修飾子と型メソッド説明append(char c) 指定された文字をこのライターに追加します。append(CharSequence csq) 指定された文字シーケンスをこのライターに追加します。append(CharSequence csq, int start, int end) 指定された文字シーケンスのサブシーケンスをこのライターに追加します。voidclose()ストリームをクローズします。voidflush()ストリームをフラッシュします。voidreset()メモリー割当て済みのバッファを廃棄せずに再使用できるように、バッファをリセットします。intsize()バッファの現在のサイズを返します。char[]入力データのコピーを返します。toString()入力データを文字列に変換します。voidwrite(char[] c, int off, int len) バッファに文字を書き込みます。voidwrite(int c) バッファに単一の文字を書き込みます。void文字列の一部をバッファに書き込みます。voidバッファの内容を別の文字ストリームに書き込みます。クラスjava.io.Writerで宣言されたメソッドnullWriter, write, write
- 
フィールド詳細- 
bufprotected char[] bufデータが格納されるバッファです。
- 
countprotected int countバッファの中の文字数です。
 
- 
- 
コンストラクタの詳細- 
CharArrayWriterpublic CharArrayWriter()CharArrayWriterを新しく作成します。
- 
CharArrayWriterpublic CharArrayWriter(int initialSize) 指定された初期サイズでCharArrayWriterを新しく作成します。- パラメータ:
- initialSize- バッファの初期サイズを指定するint。
- 例外:
- IllegalArgumentException- initialSizeが負の値の場合
 
 
- 
- 
メソッドの詳細- 
write
- 
writepublic void write(char[] c, int off, int len) バッファに文字を書き込みます。- 定義:
- write、クラス- Writer
- パラメータ:
- c- 書き込まれるデータ
- off- データ内の開始オフセット
- len- 書き込む文字数
- 例外:
- IndexOutOfBoundsException-- offが負の場合、または- lenが負の場合、または- off + lenが負の場合、または指定された配列の長さより大きい場合
 
- 
writepublic void write(String str, int off, int len) 文字列の一部をバッファに書き込みます。- オーバーライド:
- write、クラス- Writer
- パラメータ:
- str- 書き込まれる文字列
- off- 文字の読込み開始オフセット
- len- 書き込む文字数
- 例外:
- IndexOutOfBoundsException-- offが負の場合、または- lenが負の場合、または- off + lenが負の場合、または指定された文字列の長さより大きい場合
 
- 
writeTopublic void writeTo(Writer out) throws IOException バッファの内容を別の文字ストリームに書き込みます。- パラメータ:
- out- 書込み先の出力ストリーム
- 例外:
- IOException- 入出力エラーが発生した場合。
 
- 
appendpublic CharArrayWriter append(CharSequence csq) 指定された文字シーケンスをこのライターに追加します。out.append(csq)形式のこのメソッドの起動は、起動とまったく同じように動作out.write(csq.toString())文字シーケンス csqのtoStringの指定によっては、シーケンス全体が追加されない場合があります。 たとえば、文字バッファのtoStringメソッドを呼び出すと、内容がバッファの位置と制限によって異なる部分列が返されます。- 定義:
- append、インタフェース- Appendable
- オーバーライド:
- append、クラス- Writer
- パラメータ:
- csq- 追加するcharシーケンス。- csqが- nullの場合、このライターに4文字の- "null"が追加されます。
- 戻り値:
- このライター
- 導入されたバージョン:
- 1.5
 
- 
appendpublic CharArrayWriter append(CharSequence csq, int start, int end) 指定された文字シーケンスのサブシーケンスをこのライターに追加します。csqがnullでない場合、out.append(csq, start, end)という形式のこのメソッドの呼出しは、起動とまったく同じように動作out.write(csq.subSequence(start, end).toString())- 定義:
- append、インタフェース- Appendable
- オーバーライド:
- append、クラス- Writer
- パラメータ:
- csq- サブシーケンスの追加元のcharシーケンス。- csqが- nullの場合、- csqに4文字の- "null"が含まれているかのように、文字が追加されます。
- start- サブシーケンスの最初のcharのインデックス
- end- サブシーケンスの最後のcharのあとに続くcharのインデックス
- 戻り値:
- このライター
- 例外:
- IndexOutOfBoundsException-- startまたは- endが負の場合、- startが- endより大きいか、- endが- csq.length()より大きいです
- 導入されたバージョン:
- 1.5
 
- 
appendpublic CharArrayWriter append(char c) 指定された文字をこのライターに追加します。out.append(c)形式のこのメソッドの起動は、起動とまったく同じように動作out.write(c)- 定義:
- append、インタフェース- Appendable
- オーバーライド:
- append、クラス- Writer
- パラメータ:
- c- 追加する16ビット文字
- 戻り値:
- このライター
- 導入されたバージョン:
- 1.5
 
- 
resetpublic void reset()メモリー割当て済みのバッファを廃棄せずに再使用できるように、バッファをリセットします。
- 
toCharArraypublic char[] toCharArray()入力データのコピーを返します。- 戻り値:
- この入力データからコピーされた文字の配列。
 
- 
sizepublic int size()バッファの現在のサイズを返します。- 戻り値:
- バッファの現在のサイズを表すint。
 
- 
toString
- 
flush
- 
close
 
-