鸿蒙OS CharSequence
CharSequence
public interface CharSequenceCharSequence 是一个可读的 char 值序列。 此接口提供对许多不同类型的字符序列的统一只读访问。 char 值表示基本多语言平面 (BMP) 中的字符或代理项。
这个接口没有细化 equals 和 hashCode 方法的一般契约。 因此，比较实现 CharSequence 的两个对象的结果通常是未定义的。 每个对象都可以由不同的类实现，并且不能保证每个类都能够测试其实例与其他类的实例是否相等。 因此，将任意 CharSequence 实例用作集合中的元素或映射中的键是不合适的。
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| char | charAt(int index) | 返回指定索引处的 char 值。 |
| default IntStream | chars() | 返回一个 int 流，对该序列中的 char 值进行零扩展。 |
| default IntStream | codePoints() | 从该序列返回代码点值流。 |
| int | length() | 返回此字符序列的长度。 |
| CharSequence | subSequence(int start, int end) | 返回作为此序列子序列的 CharSequence。 |
| String | toString() | 以与此序列相同的顺序返回包含此序列中字符的字符串。 |
方法详情
length
int length()
返回此字符序列的长度。 长度是序列中 16 位字符的数量。
返回:
此序列中的字符数
charAt
char charAt(int index)
返回指定索引处的 char 值。 索引范围从零到 length() - 1。序列的第一个 char 值在索引 0 处，下一个在索引 1 处，依此类推，与数组索引一样。
如果索引指定的 char 值是代理项，则返回代理项值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 要返回的 char 值的索引 |
返回:
指定的字符值
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果 index 参数为负数或不小于 length() |
subSequence
CharSequence subSequence(int start, int end)
返回作为此序列子序列的 CharSequence。 子序列以指定索引处的 char 值开始，以索引 end - 1 处的 char 值结束。返回序列的长度（以字符为单位）为 end - start，因此如果 start == end 则返回空序列 .
参数：
| 参数名称 | 参数描述 |
|---|---|
| start | 起始索引，包括 |
| end | 结束索引，独占 |
返回:
指定的子序列
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果 start 或 end 为负数，如果 end 大于 length()，或者如果 start 大于 end |
toString
String toString()
以与此序列相同的顺序返回包含此序列中字符的字符串。 字符串的长度就是这个序列的长度。
覆盖：
类 Object 中的 toString
返回:
正好由这个字符序列组成的字符串
chars
default IntStream chars()
返回一个 int 流，对该序列中的 char 值进行零扩展。 任何映射到代理代码点的字符都会未经解释地传递。
如果在读取流时序列发生突变，则结果未定义。
返回:
来自此序列的 char 值的 IntStream
codePoints
default IntStream codePoints()
从该序列返回代码点值流。 序列中遇到的任何代理对都被组合起来，就像通过 Character#toCodePoint 一样，并将结果传递给流。 任何其他代码单元，包括普通 BMP 字符、不成对的代理和未定义的代码单元，都被零扩展为 int 值，然后将其传递给流。
如果在读取流时序列发生突变，则结果未定义。
返回:
来自此序列的 Unicode 代码点的 IntStream