鸿蒙OS Appendable
Appendable
public interface Appendable可以附加字符序列和值的对象。 Appendable 接口必须由其实例旨在从 Formatter 接收格式化输出的任何类实现。
要附加的字符应该是有效的 Unicode 字符，如 Unicode 字符表示中所述。 请注意，补充字符可能由多个 16 位 char 值组成。
附加组件对于多线程访问不一定是安全的。 线程安全是扩展和实现此接口的类的责任。
由于该接口可能由具有不同错误处理风格的现有类实现，因此无法保证错误将传播到调用者。
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| 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。 |
返回:
对本附录的引用
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
append
Appendable append(CharSequence csq, int start, int end) throws IOException
将指定字符序列的子序列附加到此 Appendable。
当 csq 不为空时，以 out.append(csq, start, end) 形式调用此方法的行为与调用完全相同
out.append(csq.subSequence(start, end)) 参数:
| 参数名称 | 参数描述 |
|---|---|
| csq | 从中追加子序列的字符序列。 如果 csq 为 null，则将附加字符，就好像 csq 包含四个字符“null”。 |
| start | 子序列中第一个字符的索引 |
| end | 子序列中最后一个字符之后的字符的索引 |
返回:
对本附录的引用
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果 start 或 end 为负数，则 start 大于 end，或者 end 大于 csq.length() |
| IOException | 如果发生 I/O 错误 |
append
Appendable append(char c) throws IOException
将指定的字符附加到此 Appendable。
参数：
| 参数名称 | 参数描述 |
|---|---|
| c | 要附加的字符 |
返回:
对本附录的引用
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |