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