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

返回：

一個完全由此序列的字元組成的字元串