当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

CharSequence (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

---

方法摘要
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

返回：

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

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

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