CharSequence (Java Platform SE 8 )

All Known Subinterfaces:

Name

所有已知实现类：

CharBuffer ， Segment ， String ， StringBuffer ， StringBuilder
```
public interface CharSequence
```
CharSequence是char值的可读序列。该界面提供统一的，只读访问许多不同类型的char序列。 char值代表基本多语言平面（BMP）或代理中的一个字符。详见Unicode Character Representation 。
此界面不会完善equals和hashCode方法的一般合同。因此，比较两个对象实现CharSequence其结果是，在一般情况下，不确定的。每个对象可以由不同的类实现，并且不能保证每个类都能够测试其实例以与另一个类相同。因此，使用任意的CharSequence实例作为集合中的元素或映射中的键是不合适的。

从以下版本开始：

1.4

方法摘要

所有方法接口方法抽象方法 Default Methods
Modifier and Type	Method and Description
`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值结束 。返回序列的长度（ char s）为end - start ，因此如果start == end则返回一个空序列。
    
    参数
    
    start - 包含起始索引
    
    end - 结束索引，独占
    
    结果
    
    指定的子序列
    
    异常
    
    IndexOutOfBoundsException - 如果 start或 end为负数，如果 end大于 length() ，或者如果 start大于 end
  - toString
```
String toString()
```
    以与此顺序相同的顺序返回包含此序列中的字符的字符串。字符串的长度将是此序列的长度。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    一个由这个字符序列组成的字符串
  - chars
```
default IntStream chars()
```
    返回int的流，从这个序列零扩展char值。映射到surrogate code point的任何字符通过未解释的方式传递。
    如果序列在流被读取时被突变，则结果是未定义的。
    
    结果
    
    这个序列中的char值的IntStream
    
    从以下版本开始：
    
    1.8
  - codePoints
```
default IntStream codePoints()
```
    从此序列返回码流值。在序列中遇到的任何替代对都被组合，就像Character.toCodePoint一样，并将结果传递给流。任何其他代码单元，包括普通的BMP字符，未配对代理和未定义的代码单元，都被零扩展到int值，然后将其传递给流。
    如果序列在流被读取时被突变，则结果是未定义的。
    
    结果
    
    Unicode序列的IntStream从这个序列中指向
    
    从以下版本开始：
    
    1.8

Interface CharSequence

方法摘要

方法详细信息

length

charAt

subSequence

toString

chars

codePoints