java.lang
インタフェース CharSequence

既知の実装クラスの一覧:

String, StringBuffer

public interface CharSequence

CharSequence は、読み取り可能な文字シーケンスです。このインタフェースは、さまざまな種類の文字シーケンスへの統一された読み取り専用アクセスを提供します。

このインタフェースは、equals および hashCode メソッドの汎用規約を洗練させるものではありません。このため、CharSequence を実装する 2 つのオブジェクトの比較結果は、通常、定義されていません。各オブジェクトを異なるクラスを使用して実装できるため、各クラスがそのインスタンスをほかのクラスのインスタンスと等価かどうか検査できるという保証はありません。したがって、セットの要素としてまたはマップのキーとして、任意の CharSequence インスタンスを使うのは不適切です。

導入されたバージョン:

1.4

メソッドの概要

char	charAt(int index) 指定されたインデックスの文字を返します。
int	length() この文字シーケンスの長さを返します。
CharSequence	subSequence(int start, int end) このシーケンスのサブシーケンスである新規文字シーケンスを返します。
String	toString() このシーケンス内の文字を含む文字列を、このシーケンスと同じ順序で返します。

メソッドの詳細

length

int length()

この文字シーケンスの長さを返します。長さはシーケンス内の 16 ビット Unicode 文字の数に等しくなります。

戻り値:

このシーケンス内の文字数

charAt

char charAt(int index)

指定されたインデックスの文字を返します。インデックスは、0 から length() - 1 の範囲になります。配列のインデックス付けの場合と同じように、シーケンスの最初の文字のインデックスは 0、次の文字のインデックスは 1 と続きます。

パラメータ:

index - 返される文字のインデックス

戻り値:

指定された文字

例外:

IndexOutOfBoundsException - index 引数が負の値または length() より小さい場合

subSequence

CharSequence subSequence(int start,
                         int end)

このシーケンスのサブシーケンスである新規文字シーケンスを返します。サブシーケンスは、指定されたインデックスの文字で始まり、インデックス end - 1 の文字で終わります。返されるシーケンスの長さは end - start です。このため、start == end の場合、空のシーケンスが返されます。

パラメータ:

start - 開始インデックス (この値を含む)

end - 終了インデックス (この値を含まない)

戻り値:

指定されたサブシーケンス

例外:

IndexOutOfBoundsException - start または end が負の値の場合、end が length() より大きい場合、あるいは start が end より大きい場合

toString

String toString()

このシーケンス内の文字を含む文字列を、このシーケンスと同じ順序で返します。このシーケンスの長さが、文字列の長さになります。

オーバーライド:

クラス Object 内の toString

戻り値:

この文字列シーケンスだけで構成された文字列