compact1, compact2, compact3

java.lang

Interface Appendable

所有已知实现类：

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

public interface Appendable

可附加char序列和值的对象。 Appendable接口必须由其实例旨在从Formatter接收格式化输出的任何类实现 。

要附加的字符应为Unicode Character Representation中描述的有效Unicode字符。 请注意，补充字符可以由多个16位char值组成。

对于多线程访问，附加功能不一定是安全的。 线程安全是扩展和实现这个接口的类的责任。

由于此接口可能由具有不同样式的错误处理的现有类实现，因此不能保证将错误传播到调用者。

从以下版本开始：

1.5

方法摘要

Modifier and Type	Method and Description
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 ，则四个字符"null"附加到该附录。

结果

提到这个 Appendable

异常

IOException - 如果发生I / O错误

append

Appendable append(CharSequence csq,
                  int start,
                  int end)
           throws IOException

将指定的字符序列的子序列附加到此Appendable 。

形式的这种方法的调用时out.append(csq, start, end) csq不是null，行为以完全相同的方式调用

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

参数

csq - 追加子序列的字符序列。 如果csq是null ，则会附加字符 ，如果csq包含四个字符"null" 。

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错误