-
- All Known Subinterfaces:
-
Name
- 所有已知实现类:
-
CharBuffer,Segment,String,StringBuffer,StringBuilder
public interface CharSequenceCharSequence是char值的可读序列。 该接口提供对许多不同类型的char序列的统一,只读访问。char值表示基本多语言平面(BMP)中的字符或代理项。 有关详细信息,请参阅Unicode Character Representation 。此接口不会细化
equals和hashCode方法的常规合同。 因此,测试实现CharSequence两个对象的相等性的结果通常是未定义的。 每个对象可以由不同的类实现,并且不能保证每个类都能够测试其实例与另一个类的实例是否相等。 因此,将任意CharSequence实例用作集合中的元素或映射中的键是不合适的。- 从以下版本开始:
- 1.4
-
-
方法摘要
所有方法 静态方法 实例方法 抽象方法 Default Methods 变量和类型 方法 描述 charcharAt(int index)返回指定索引处的char值。default IntStreamchars()返回int的流,对此序列中的char值进行零扩展。default IntStreamcodePoints()返回此序列中的代码点值流。static intcompare(CharSequence cs1, CharSequence cs2)CharSequence字典顺序比较两个CharSequence实例。intlength()返回此字符序列的长度。CharSequencesubSequence(int start, int end)返回CharSequence,它是此序列的子序列。StringtoString()以与此序列相同的顺序返回包含此序列中字符的字符串。
-
-
-
方法详细信息
-
length
int length()
返回此字符序列的长度。 长度是序列中16位char的数量。- 结果
-
此序列中的数量为
char
-
charAt
char charAt(int index)
返回指定索引处的char值。 索引范围为0到length() - 1。 序列的第一个char值在索引0处,下一个在索引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值,然后将int值传递给流。当终端流操作开始时,流绑定到该序列(具体地,对于可变序列,流的分裂器是late-binding )。 如果在该操作期间修改了序列,则结果是未定义的。
- 结果
- Unicode代码的IntStream指向此序列
- 从以下版本开始:
- 1.8
-
compare
static int compare(CharSequence cs1, CharSequence cs2)
CharSequence字典顺序比较两个CharSequence实例。 如果第一个序列按字典顺序小于,等于或大于第二个序列,则返回负值,零或正值。CharSequence的字典顺序定义如下。 考虑长度为len的CharSequencecs为char值序列, cs [0]到cs [len-1] 。 假设k是每个序列的相应char值不同的最低索引。 序列的词典排序通过char值cs1 [k]与cs2 [k]的数值比较来确定。 如果没有这样的索引k ,则较短的序列在字典上被认为小于另一个。 如果序列具有相同的长度,则认为序列在词典上相等。- 参数
-
cs1- 第一个CharSequence -
cs2- 第二个CharSequence - 结果
-
如果两个
CharSequence相等,则值0; 如果第一个CharSequence字典顺序小于第二个,CharSequence负整数; 如果第一个CharSequence字典顺序大于第二个,CharSequence正整数。 - 从以下版本开始:
- 11
-
-