- 既知のすべての実装クラス:
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
- 追加する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
- サブシーケンスの最初のcharのインデックスend
- サブシーケンスの最後のcharのあとに続くcharのインデックス- 戻り値:
- この
Appendable
への参照 - 例外:
IndexOutOfBoundsException
-start
またはend
が負の値の場合、start
がend
よりも大きい場合、あるいはend
がcsq.length()
よりも大きい場合IOException
- 入出力エラーが発生した場合
-
append
Appendable append(char c) throws IOExceptionこのAppendable
に指定された文字を追加します。- パラメータ:
c
- 追加される文字- 戻り値:
- この
Appendable
への参照 - 例外:
IOException
- 入出力エラーが発生した場合
-