モジュール 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

        Appendable append​(CharSequence csq)
           throws IOException
        このAppendableに指定された文字シーケンスを追加します。

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

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

      • append

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

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

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

      • append

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