JavaTM Platform
Standard Ed. 6

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 を実装するクラスによっては、文字シーケンス全体が追加されない可能性があります。たとえば、csqCharBuffer である場合、追加される文字サブシーケンスはバッファーの位置または制限によって定義されます。

パラメータ:
csq - 追加される文字シーケンス。csqnull の場合は、この Appendable に「null」という 4 文字が追加される
戻り値:
この Appendable への参照
例外:
IOException - 入出力エラーが発生した場合

append

Appendable append(CharSequence csq,
                  int start,
                  int end)
                  throws IOException
この Appendable に指定された文字シーケンスのサブシーケンスを追加します。  

csqnull ではないときに、このメソッドを out.append(csq, start, end) の形式で呼び出した場合、次の呼び出しと同じ結果が得られます。  

     out.append(csq.subSequence(start, end)) 

パラメータ:
csq - サブシーケンスの追加元の文字シーケンス。csqnull であれば、csq に「null」という 4 文字が含まれているかのように追加される
start - サブシーケンスの最初の文字のインデックス
end - サブシーケンスの最後の文字のあとに続く文字のインデックス
戻り値:
この Appendable への参照
例外:
IndexOutOfBoundsException - start または end が負の値の場合、startend より大きい場合、または endcsq.length() より大きい場合
IOException - 入出力エラーが発生した場合

append

Appendable append(char c)
                  throws IOException
この Appendable に指定された文字を追加します。

パラメータ:
c - 追加される文字
戻り値:
この Appendable への参照
例外:
IOException - 入出力エラーが発生した場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。