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 序列和值的对象。如果某个类的实例打算接收取自 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。例如,如果 csqCharBuffer 的一个实例,则通过缓冲区的位置和限制来定义要添加的子序列。

参数:
csq - 要添加的字符串序列。如果 csqnull,则向该 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 - 子序列将被添加的字符序列。如果 csqnull,则添加四个字符 "null",就好像 csq 包含这些字符一样。
start - 子序列中第一个字符的索引
end - 紧随子序列中最后一个字符的字符的索引
返回:
Appendable 的引用
抛出:
IndexOutOfBoundsException - 如果 startend 为负,以及 start 大于 end 或者 end 大于 csq.length()
IOException - 如果发生 I/O 错误

append

Appendable append(char c)
                  throws IOException
向此 Appendable 添加指定字符。

参数:
c - 要添加的字符
返回:
Appendable 的引用
抛出:
IOException - 如果发生 I/O 错误

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策