|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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 错误
所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |