JavaTM 2 Platform
Standard Ed. 5.0

java.lang
接口 CharSequence

所有已知实现类:
String, StringBuffer, StringBuilder

public interface CharSequence

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

此接口不修改 equalshashCode 方法的常规协定。因此,通常未定义比较实现 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 - 1char 值结束。返回序列的长度(char 中)是 end - start,因此,如果 start == end,则返回一个空序列。

参数:
start - 开始索引(包括)
end - 结束索引(不包括)
返回:
指定的子序列
抛出:
IndexOutOfBoundsException - 如果 startend 为负,end 大于 length() 或者 start 大于 end

toString

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

覆盖:
Object 中的 toString
返回:
一个完全由此序列的字符组成的字符串

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策