public interface CharSequence
| java.lang.CharSequence |
 Known Indirect Subclasses
|
CharSequence是char值的可读序列。 该接口为许多不同类型的char序列提供统一的只读访问。 char值表示基本多语言平面（BMP）或替代品中的字符。 详情请参阅Unicode Character Representation 。
该界面不会细化equals和hashCode方法的一般合同。 因此，比较实现CharSequence的两个对象的结果通常是未定义的。 每个对象都可以由不同的类来实现，并且不能保证每个类都能够测试其实例与其他实例的相等性。 因此，将任意CharSequence实例用作集中的元素或映射中的键是不合适的。
Public methods |
|
|---|---|
abstract char |
charAt(int index) 返回指定索引处的值 |
default IntStream |
chars() 返回 |
default IntStream |
codePoints() 从该序列返回一个代码点值流。 |
abstract int |
length() 返回此字符序列的长度。 |
abstract CharSequence |
subSequence(int start, int end) 返回一个新的 |
abstract String |
toString() 以与此序列相同的顺序返回包含此序列中字符的字符串。 |
char charAt (int index)
返回指定索引处的值char 。 索引范围从0到length() - 1 。 序列的第一个char值是索引零，下一个是索引一，依此类推，如同数组索引。
如果索引指定的 char值为 surrogate ，则返回代理值。
| Parameters | |
|---|---|
index |
int: the index of the char value to be returned |
| Returns | |
|---|---|
char |
the specified char value |
| Throws | |
|---|---|
IndexOutOfBoundsException |
if the index argument is negative or not less than length() |
IntStream chars ()
返回流int延伸零char从该序列值。 映射到surrogate code point的任何字符都将通过未解释的字符传递。
如果在读取流时序列发生了变化，结果是未定义的。
| Returns | |
|---|---|
IntStream |
an IntStream of char values from this sequence |
IntStream codePoints ()
从该序列返回一个代码点值流。 在序列中遇到的任何代理对都会像Character.toCodePoint那样合并，并将结果传递给流。 任何其他代码单元（包括普通BMP字符，未配对的代理单元和未定义的代码单元）都被零扩展为int值，然后将其传递给流。
如果在读取流时序列发生了变化，结果是未定义的。
| Returns | |
|---|---|
IntStream |
an IntStream of Unicode code points from this sequence |
int length ()
返回此字符序列的长度。 长度是序列中的16位char的数量。
| Returns | |
|---|---|
int |
the number of chars in this sequence |
CharSequence subSequence (int start, int end)
返回一个新的CharSequence ，它是这个序列的子序列。 该子序列与所述启动char指定索引处值和与所述结束char在索引end - 1值。 返回序列的长度（ char s）为end - start ，所以如果start == end则返回空序列。
| Parameters | |
|---|---|
start |
int: the start index, inclusive |
end |
int: the end index, exclusive |
| Returns | |
|---|---|
CharSequence |
the specified subsequence |
| Throws | |
|---|---|
IndexOutOfBoundsException |
if start or end are negative, if end is greater than length(), or if start is greater than end |
String toString ()
以与此序列相同的顺序返回包含此序列中字符的字符串。 字符串的长度将是该序列的长度。
| Returns | |
|---|---|
String |
a string consisting of exactly this sequence of characters |
Android开发手册