-
- All Known Subinterfaces:
-
Name
- 所有已知实现类:
-
CharBuffer
,Segment
,String
,StringBuffer
,StringBuilder
public interface CharSequence
ACharSequence
是char
值的可读序列。 该接口提供对许多不同类型的char
序列的统一的只读访问。 Achar
值表示基本多语言平面(BMP)或代理中的字符。 详见Unicode Character Representation 。此接口不会改进
equals
和hashCode
方法的一般合同。 因此,比较实现CharSequence
两个对象的结果CharSequence
是未定义的。 每个对象可以由不同的类实现,并且不能保证每个类都能够测试其实例以与另一个类相同。 因此,使用任意CharSequence
实例作为集合中的元素或映射中的键是不合适的。- 从以下版本开始:
- 1.4
-
-
方法摘要
所有方法 接口方法 抽象方法 Default Methods Modifier and Type 方法 描述 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位char
的数量。- 结果
-
这个序列中的数字为
char
-
charAt
char charAt(int index)
返回指定索引处的char
值。 索引范围从零到length() - 1
。 序列的第一个char
值在索引为零,下一个索引为1,依此类推,就像数组索引一样。如果索引指定的
char
值为surrogate ,则返回替代值。- 参数
-
index
- 要返回的char
值的索引 - 结果
-
指定
char
值 - 异常
-
IndexOutOfBoundsException
- 如果index
参数为负数或不小于length()
-
subSequence
CharSequence subSequence(int start, int end)
返回一个CharSequence
,这是这个序列的子序列。 该子序列与所述启动char
指定索引处值和与所述结束char
在索引值end - 1
。 返回序列的长度(char
s)为end - start
,因此如果start == end
返回一个空序列。- 参数
-
start
- 开始索引(含) -
end
- 结束索引,独占 - 结果
- 指定的子序列
- 异常
-
IndexOutOfBoundsException
- 如果start
或end
为负数,如果end
大于length()
,或者如果start
大于end
-
toString
String toString()
以与此顺序相同的顺序返回包含此序列中的字符的字符串。 字符串的长度将是此序列的长度。
-
chars
default IntStream chars()
返回一个int
的数据流,从这个序列中扩展char
值。 映射到surrogate code point的任何字符都通过未解释的方式传递。当终端流操作开始时(特别地,对于可变序列,流的分流器是late-binding ),流与该序列绑定。 如果序列在该操作期间被修改,则结果是未定义的。
- 结果
- 这个序列中的char值的IntStream
- 从以下版本开始:
- 1.8
-
codePoints
default IntStream codePoints()
从此序列返回码流值。 在序列中遇到的任何代理对被组合,如同通过Character.toCodePoint一样 ,并将结果传递给流。 任何其他代码单元,包括普通的BMP字符,未配对代理和未定义的代码单元,都将零扩展到int
值,然后传递给流。当终端流操作开始时(特别地,对于可变序列,流的分流器是late-binding ),流与该序列绑定。 如果序列在该操作期间被修改,则结果是未定义的。
- 结果
- Unicode序列的IntStream从这个序列中指向
- 从以下版本开始:
- 1.8
-
-