java.lang
介面 Appendable

所有已知實作類別：

BufferedWriter, CharArrayWriter, CharBuffer, FileWriter, FilterWriter, LogStream, OutputStreamWriter, PipedWriter, PrintStream, PrintWriter, StringBuffer, StringBuilder, StringWriter, Writer

public interface Appendable

能夠被添加 char 序列和值的物件。如果某個類別的實例打算接收取自 Formatter 的格式化輸出，那麼該類別必須實作 Appendable 介面。

要添加的字元應該是有效的 Unicode 字元，正如 Unicode Character Representation 中描述的那樣。注意，增補字元可能由多個 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"。

返回：

此 Appendable 的參考

拋出：

IOException - 如果發生 I/O 錯誤

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，則添加四個字元 "null"，就好像 csq 套件含這些字元一樣。

start - 子序列中第一個字元的索引

end - 緊隨子序列中最後一個字元的字元的索引

返回：

此 Appendable 的參考

拋出：

IndexOutOfBoundsException - 如果 start 或 end 為負，以及 start 大於 end 或者 end 大於 csq.length()

IOException - 如果發生 I/O 錯誤

append

Appendable append(char c)
                  throws IOException

向此 Appendable 添加指定字元。

參數：

c - 要添加的字元

返回：

此 Appendable 的參考

拋出：

IOException - 如果發生 I/O 錯誤