鸿蒙OS开发文档 鸿蒙OS Appendable

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 3

Appendable

public interface Appendable

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

要附加的字符应该是有效的 Unicode 字符,如 Unicode 字符表示中所述。 请注意,补充字符可能由多个 16 位 char 值组成。

附加组件对于多线程访问不一定是安全的。 线程安全是扩展和实现此接口的类的责任。

由于该接口可能由具有不同错误处理风格的现有类实现,因此无法保证错误将传播到调用者。

方法总结

修饰符和类型方法描述
Appendableappend(char c)将指定的字符附加到此 Appendable。
Appendableappend(CharSequence csq)将指定的字符序列附加到此 Appendable。
Appendableappend(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 错误