java.lang
接口 CharSequence

所有已知子接口：

Name

所有已知实现类：

CharBuffer, Segment, String, StringBuffer, StringBuilder

public interface CharSequence

CharSequence 是 char 值的一个可读序列。此接口对许多不同种类的 char 序列提供统一的只读访问。char 值表示 Basic Multilingual Plane (BMP) 或代理项中的一个字符。有关详细信息，请参阅 Unicode 字符表示形式。

此接口不修改 equals 和 hashCode 方法的常规协定。因此，通常未定义比较实现 CharSequence 的两个对象的结果。每个对象都可以通过一个不同的类实现，而且不能保证每个类能够测试其实例与其他类的实例的相等性。因此，使用任意 CharSequence 实例作为集合中的元素或映射中的键是不合适的。

从以下版本开始：

1.4

方法摘要

char	charAt(int index) 返回指定索引的 char 值。
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 值是索引零，下一个是索引一，依此类推。

如果索引指定的 char 值是代理项，则返回代理项的值。

参数：

index - 要返回的 char 值的索引

返回：

指定的 char 值

抛出：

IndexOutOfBoundsException - 如果 index 参数为负或不小于 length()

subSequence

CharSequence subSequence(int start,
                         int end)

返回一个新的 CharSequence，它是此序列的子序列。子序列从指定序列的 char 值开始，并在索引 end - 1 的 char 值结束。返回序列的长度（char 中）是 end - start，因此，如果 start == end，则返回一个空序列。

参数：

start - 开始索引（包括）

end - 结束索引（不包括）

返回：

指定的子序列

抛出：

IndexOutOfBoundsException - 如果 start 或 end 为负，end 大于 length() 或者 start 大于 end

toString

String toString()

返回一个包含此序列中字符的字符串，该字符串与此序列的顺序相同。字符串的长度就是此序列的长度。

覆盖：

类 Object 中的 toString

返回：

一个完全由此序列的字符组成的字符串