java.lang

インタフェース CharSequence

既知のすべてのサブインタフェース:

Name

既知のすべての実装クラス:

CharBuffer, Segment, String, StringBuffer, StringBuilder

public interface CharSequence

CharSequence は char 値の読み取り可能なシーケンスです。このインタフェースは、さまざまな種類の char シーケンスへの統一された読み取り専用アクセスを提供します。char 値は、基本多言語面 (BMP) またはサロゲートの文字を表します。詳細は、Unicode 文字表現を参照してください。

このインタフェースは、equals メソッドと hashCode メソッドの汎用規約を洗練させるものではありません。このため、CharSequence を実装する 2 つのオブジェクトの比較結果は、通常、定義されていません。各オブジェクトを異なるクラスを使用して実装できるため、各クラスがそのインスタンスをほかのクラスのインスタンスと等価かどうか検査できるという保証はありません。したがって、セットの要素としてまたはマップのキーとして、任意の 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 値を返します。インデックスは、0 から length() - 1 の範囲になります。配列のインデックス付けの場合と同じように、シーケンスの最初の char のインデックスは 0、次の文字のインデックスは 1 と続きます。

インデックスで指定された 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()

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

オーバーライド:

toString、クラス: Object

戻り値:

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