CharSequence - [ Java参考文档 ] - 在线原生手册

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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

返回：: 一个完全由此序列的字符组成的字符串

概述