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 - 入出力エラーが発生した場合