Java java.lang 接口 CharSequence（JDK5）

所有类

java.lang
接口 CharSequence

所有已知实现类：

CharBuffer, String, StringBuffer, StringBuilder

public interface CharSequence

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

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

从以下版本开始：

1.4

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

返回：

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