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

クラスStringWriter

java.lang.Object
java.io.Writer
java.io.StringWriter
すべての実装されたインタフェース:
Closeable, Flushable, Appendable, AutoCloseable
public class StringWriter extends Writer
出力を文字列バッファに集める文字ストリームです。この文字列バッファを使って文字列を構築します。

StringWriterをクローズしても効果はありません。 このクラスのメソッドは、IOExceptionを生成せずにストリームがクローズされた後にコールできます。

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

  • フィールドのサマリー

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

    lock

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

    コンストラクタ
    コンストラクタ
    説明
    StringWriter()
    デフォルトの初期文字列バッファ・サイズを使って、新しい文字列ライターを作成します。
    StringWriter(int initialSize)
    指定された初期文字列バッファ・サイズを使って、新しい文字列ライターを作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    StringWriter
    append(char c)
    指定された文字をこのライターに追加します。
    StringWriter
    append(CharSequence csq)
    指定された文字シーケンスをこのライターに追加します。
    StringWriter
    append(CharSequence csq, int start, int end)
    指定された文字シーケンスのサブシーケンスをこのライターに追加します。
    void
    close()
    StringWriterをクローズしても効果はありません。
    void
    flush()
    ストリームをフラッシュします。
    StringBuffer
    getBuffer()
    文字列バッファそのものを返します。
    String
    toString()
    バッファの現在の値を文字列として返します。
    void
    write(char[] cbuf, int off, int len)
    文字の配列の一部を書き込みます。
    void
    write(int c)
    単一の文字を書き込みます。
    void
    write(String str)
    文字列を書き込みます。
    void
    write(String str, int off, int len)
    文字列の一部を書き込みます。

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

    nullWriter, write

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

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

  • コンストラクタの詳細

    • StringWriter

      public StringWriter()
      デフォルトの初期文字列バッファ・サイズを使って、新しい文字列ライターを作成します。

    • StringWriter

      public StringWriter(int initialSize)
      指定された初期文字列バッファ・サイズを使って、新しい文字列ライターを作成します。
      パラメータ:
      initialSize - 自動的に展開される前に、このバッファに収まるchar値の数
      例外:
      IllegalArgumentException - initialSizeが負の場合

  • メソッドの詳細

    • write

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

    • write

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

    • write

      public void write(String str)
      文字列を書き込みます。
      オーバーライド:
      write、クラスWriter
      パラメータ:
      str - 書き込まれる文字列

    • write

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

    • append

      public StringWriter 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

    • append

      public StringWriter 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 StringWriter append(char c)
      指定された文字をこのライターに追加します。

      out.append(c)形式のこのメソッドの起動は、起動とまったく同じように動作 

           out.write(c)

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

    • toString

      public String toString()
      バッファの現在の値を文字列として返します。
      オーバーライド:
      toString、クラスObject
      戻り値:
      このオブジェクトの文字列表現

    • getBuffer

      public StringBuffer getBuffer()
      文字列バッファそのものを返します。
      戻り値:
      現在のバッファ値を保持するStringBuffer。

    • flush

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

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

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

    • close

      public void close() throws IOException
      StringWriterをクローズしても効果はありません。 このクラスのメソッドは、IOExceptionを生成せずにストリームがクローズされた後にコールできます。
      定義:
      close、インタフェースAutoCloseable
      定義:
      close、インタフェースCloseable
      定義:
      close、クラスWriter
      例外:
      IOException - 入出力エラーが発生した場合