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

メソッドの概要

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

メソッドの詳細

append

Appendable append(CharSequence csq)
                  throws IOException

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

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

パラメータ:

csq - 追加される文字シーケンス。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 - サブシーケンスの追加元の文字シーケンス。csq が null であれば、csq に「null」という 4 文字が含まれているかのように追加される

start - サブシーケンスの最初の文字のインデックス

end - サブシーケンスの最後の文字のあとに続く文字のインデックス

戻り値:

この Appendable への参照

例外:

IndexOutOfBoundsException - start または end が負の値の場合、start が end より大きい場合、または end が csq.length() より大きい場合

IOException - 入出力エラーが発生した場合

append

Appendable append(char c)
                  throws IOException

この Appendable に指定された文字を追加します。

パラメータ:

c - 追加される文字

戻り値:

この Appendable への参照

例外:

IOException - 入出力エラーが発生した場合