クラス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)
      指定された文字シーケンスをこのライターに追 します。

      csqがnullでない 合、out.append(csq)という形式のこのメソッドの起動は、呼出しとまったく同じように動作 

          out.write(csq.toString())

      文字シーケンスcsqのtoStringの指定によっては、シーケンス全体が追 されない 合があります。 たとえば、文字バッファのtoStringメソッドを呼び出すと、内容がバッファの位置と制限によって異なる部分列が返されます。

      定義:
      append、インタフェースAppendable
      オーバーライド:
      append、クラスWriter
      パラメータ:
      csq - 追 するcharシーケンス。 csqがnullの 合、このライターに4文字の"null"が追 されます。
      戻り値:
      このライター
      導入されたバージョン:
      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に4文字の"null"が含まれているかのように、文字が追 されます。
      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