- 既知のすべての実装クラス:
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
に追加します。append
(CharSequence csq) 指定した文字シーケンスをこのAppendable
に追加します。append
(CharSequence csq, int start, int end) 指定した文字シーケンスのサブシーケンスをこのAppendable
に追加します。
-
メソッドの詳細
-
append
指定した文字シーケンスをこのAppendable
に追加します。文字シーケンス
csq
を実装するクラスによっては、シーケンス全体を追加できない場合があります。 たとえば、csq
がCharBuffer
の場合、追加する部分列はバッファの位置と制限によって定義されます。- パラメータ:
csq
- 追加するcharシーケンス。csq
がnull
の場合、この追加可能には4文字の"null"
が追加されます。- 戻り値:
- この
Appendable
への参照 - 例外:
IOException
- 入出力エラーが発生した場合
-
append
指定した文字シーケンスのサブシーケンスをこのAppendable
に追加します。csq
がnull
でない場合、out.append(csq, start, end)
という形式のこのメソッドの呼出しは、起動とまったく同じように動作out.append(csq.subSequence(start, end))
- パラメータ:
csq
- サブシーケンスの追加元のcharシーケンス。csq
がnull
の場合、csq
に4文字の"null"
が含まれているかのように、文字が追加されます。start
- サブシーケンスの最初のcharのインデックスend
- サブシーケンスの最後のcharのあとに続くcharのインデックス- 戻り値:
- この
Appendable
への参照 - 例外:
IndexOutOfBoundsException
-start
またはend
が負の場合、start
がend
より大きいか、end
がcsq.length()
より大きいですIOException
- 入出力エラーが発生した場合
-
append
指定した文字をこのAppendable
に追加します。- パラメータ:
c
- 追加される文字- 戻り値:
- この
Appendable
への参照 - 例外:
IOException
- 入出力エラーが発生した場合
-