モジュール java.base
パッケージ java.io

クラスCharArrayWriter

java.lang.Object
java.io.Writer
java.io.CharArrayWriter
すべての実装されたインタフェース:
Closeable, Flushable, Appendable, AutoCloseable
public class CharArrayWriter extends Writer
このクラスは、ライターとして使用できる文字バッファを実装します。 ストリームに文字が書き込まれるに従って、バッファは自動的に大きくなります。 toCharArray()やtoString()を使ってデータを取り出すことができます。

ノート: このクラスでclose()を呼び出しても、何も変化はありません。ストリームを閉じたあとにこのクラスのメソッドを呼び出しても、IOExceptionは生成されません。

導入されたバージョン:
1.1

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    protected char[]
    buf
    データが格納されるバッファです。
    protected int
    count
    バッファの中の文字数です。

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

    lock

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

    コンストラクタ
    コンストラクタ
    説明
    CharArrayWriter()
    CharArrayWriterを新しく作成します。
    CharArrayWriter(int initialSize)
    指定された初期サイズでCharArrayWriterを新しく作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    CharArrayWriter
    append(char c)
    指定された文字をこのライターに追加します。
    CharArrayWriter
    append(CharSequence csq)
    指定された文字シーケンスをこのライターに追加します。
    CharArrayWriter
    append(CharSequence csq, int start, int end)
    指定された文字シーケンスのサブシーケンスをこのライターに追加します。
    void
    close()
    ストリームをクローズします。
    void
    flush()
    ストリームをフラッシュします。
    void
    reset()
    メモリー割当て済みのバッファを廃棄せずに再使用できるように、バッファをリセットします。
    int
    size()
    バッファの現在のサイズを返します。
    char[]
    toCharArray()
    入力データのコピーを返します。
    String
    toString()
    入力データを文字列に変換します。
    void
    write(char[] c, int off, int len)
    バッファに文字を書き込みます。
    void
    write(int c)
    バッファに単一の文字を書き込みます。
    void
    write(String str, int off, int len)
    文字列の一部をバッファに書き込みます。
    void
    writeTo(Writer out)
    バッファの内容を別の文字ストリームに書き込みます。

    クラス java.io.Writerで宣言されたメソッド

    nullWriter, write, write

    クラス java.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • フィールド詳細

    • buf

      protected char[] buf
      データが格納されるバッファです。

    • count

      protected int count
      バッファの中の文字数です。

  • コンストラクタの詳細

    • CharArrayWriter

      public CharArrayWriter()
      CharArrayWriterを新しく作成します。

    • CharArrayWriter

      public CharArrayWriter(int initialSize)
      指定された初期サイズでCharArrayWriterを新しく作成します。
      パラメータ:
      initialSize - バッファの初期サイズを指定するint。
      例外:
      IllegalArgumentException - initialSizeが負の値の場合

  • メソッドの詳細

    • write

      public void write(int c)
      バッファに単一の文字を書き込みます。
      オーバーライド:
      write、クラス: Writer
      パラメータ:
      c - 書き込まれる文字を指定するint

    • write

      public void write(char[] c, int off, int len)
      バッファに文字を書き込みます。
      定義:
      write、クラス: Writer
      パラメータ:
      c - 書き込まれるデータ
      off - データ内の開始オフセット
      len - 書き込む文字数
      例外:
      IndexOutOfBoundsException - offが負の場合、またはlenが負の場合、またはoff + lenが負の場合、または指定された配列の長さより大きい場合

    • write

      public void write(String str, int off, int len)
      文字列の一部をバッファに書き込みます。
      オーバーライド:
      write、クラス: Writer
      パラメータ:
      str - 書き込まれる文字列
      off - 文字の読込み開始オフセット
      len - 書き込む文字数
      例外:
      IndexOutOfBoundsException - offが負の場合、lenが負の場合、またはoff + lenが負であるか、指定された文字列の長さよりも大きい場合

    • writeTo

      public void writeTo(Writer out) throws IOException
      バッファの内容を別の文字ストリームに書き込みます。
      パラメータ:
      out - 書込み先の出力ストリーム
      例外:
      IOException - 入出力エラーが発生した場合。

    • append

      public CharArrayWriter append(CharSequence csq)
      指定された文字シーケンスをこのライターに追加します。

      このメソッドをout.append(csq)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。 

           out.write(csq.toString())

      charシーケンスcsqに対するtoStringの指定に応じて、シーケンス全体が追加されないこともあります。 たとえば、charバッファのtoStringメソッドを呼び出した場合、そのバッファの位置とリミットによって決まる内容を持つサブシーケンスが返されます。

      定義:
      append、インタフェース: Appendable
      オーバーライド:
      append、クラス: Writer
      パラメータ:
      csq - 追加するcharシーケンス。 csqがnullの場合は、このライターに「null」という4文字が追加される。
      戻り値:
      このライター
      導入されたバージョン:
      1.5

    • append

      public 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に「null」という4 charが含まれているかのようにcharが追加される
      start - サブシーケンスの最初のcharのインデックス
      end - サブシーケンスの最後のcharのあとに続くcharのインデックス
      戻り値:
      このライター
      例外:
      IndexOutOfBoundsException - startまたはendが負の値の場合、startがendよりも大きい場合、あるいはendがcsq.length()よりも大きい場合
      導入されたバージョン:
      1.5

    • append

      public CharArrayWriter append(char c)
      指定された文字をこのライターに追加します。

      このメソッドをout.append(c)の形式で呼び出した場合、次の呼び出しとまったく同様に動作します。 

           out.write(c)

      定義:
      append、インタフェース: Appendable
      オーバーライド:
      append、クラス: Writer
      パラメータ:
      c - 追加する16ビット文字
      戻り値:
      このライター
      導入されたバージョン:
      1.5

    • reset

      public void reset()
      メモリー割当て済みのバッファを廃棄せずに再使用できるように、バッファをリセットします。

    • toCharArray

      public char[] toCharArray()
      入力データのコピーを返します。
      戻り値:
      この入力データからコピーされた文字の配列。

    • size

      public int size()
      バッファの現在のサイズを返します。
      戻り値:
      バッファの現在のサイズを表すint。

    • toString

      public String toString()
      入力データを文字列に変換します。
      オーバーライド:
      toString 、クラス:  Object
      戻り値:
      文字列

    • flush

      public void flush()
      ストリームをフラッシュします。

      CharArrayWriterのflushメソッドは何もしません。

      定義:
      flush、インタフェース: Flushable
      定義:
      flush、クラス: Writer

    • close

      public void close()
      ストリームをクローズします。 このメソッドの内容は以降も要求されるので、バッファは解放されません。 ノート: このクラスのこのメソッドを呼び出しても、何の効果もありません。
      定義:
      close、インタフェース: AutoCloseable
      定義:
      close、インタフェース: Closeable
      定義:
      close、クラス: Writer