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

インタフェースAppendable

既知のすべての実装クラス:
BufferedWriter, CharArrayWriter, CharBuffer, FileWriter, FilterWriter, LogStream, OutputStreamWriter, PipedWriter, PrintStream, PrintWriter, StringBuffer, StringBuilder, StringWriter, Writer

public interface Appendable
charの順序と値を追加できるオブジェクト。 Appendableインタフェースは、インスタンスがFormatterから書式設定された出力を受け取ることを意図しているすべてのクラスによって実装される必要があります。

追加される文字は、Unicode文字表現で定義されている有効なUnicode文字である必要があります。 補助文字は、複数の16ビットchar値で構成できます。

Appendableは、マルチスレッド・アクセスに対して必ずしも安全ではありません。 スレッドの安全性は、このインタフェースを拡張および実装するクラスが担います。

このインタフェースは、異なるエラー処理様式を持つ既存のクラスによって実装される可能性があるので、呼出し元にエラーが伝達される保証はありません。

導入されたバージョン:
1.5
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    append(char c)
    指定した文字をこのAppendableに追加します。
    指定した文字シーケンスをこのAppendableに追加します。
    append(CharSequence csq, int start, int end)
    指定した文字シーケンスのサブシーケンスをこのAppendableに追加します。
  • メソッドの詳細

    • append

      指定した文字シーケンスをこのAppendableに追加します。

      文字シーケンスcsqを実装するクラスによっては、シーケンス全体を追加できない場合があります。 たとえば、csqCharBufferの場合、追加する部分列はバッファの位置と制限によって定義されます。

      パラメータ:
      csq - 追加するcharシーケンス。 csqnullの場合、この追加可能には4文字の"null"が追加されます。
      戻り値:
      このAppendableへの参照
      例外:
      IOException - 入出力エラーが発生した場合
    • append

      Appendable append(CharSequence csq, int start, int end) throws IOException
      指定した文字シーケンスのサブシーケンスをこのAppendableに追加します。

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

           out.append(csq.subSequence(start, end)) 

      パラメータ:
      csq - サブシーケンスの追加元のcharシーケンス。 csqnullの場合、csqに4文字の"null"が含まれているかのように、文字が追加されます。
      start - サブシーケンスの最初のcharのインデックス
      end - サブシーケンスの最後のcharのあとに続くcharのインデックス
      戻り値:
      このAppendableへの参照
      例外:
      IndexOutOfBoundsException - startまたはendが負の場合、startendより大きいか、endcsq.length()より大きいです
      IOException - 入出力エラーが発生した場合
    • append

      指定した文字をこのAppendableに追加します。
      パラメータ:
      c - 追加される文字
      戻り値:
      このAppendableへの参照
      例外:
      IOException - 入出力エラーが発生した場合