compact1、compact2、compact3

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