インタフェースCharSequence

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

Name, Utf8Entry

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

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値を返します。
default IntStream	chars()	このシーケンスのchar値をゼロ拡張したintを含むストリー� を返します。
default IntStream	codePoints()	このシーケンスからコード・ポイント値のストリー� を返します。
static int	compare(CharSequence cs1, CharSequence cs2)	2つのCharSequenceインスタンスを辞書的に比較します。
default boolean	isEmpty()	この文字シーケンスが空の� �合、trueを返します。
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()より小さい� �合

isEmpty

default boolean isEmpty()

この文字シーケンスが空の� �合、trueを返します。

実装要件:

デフォルトの実装では、length() == 0をコールした結果が返されます。

戻り値:

length()が0の� �合はtrue、それ以外の� �合はfalse

導入されたバージョン:

15

subSequence

CharSequence subSequence(int start, int end)

このシーケンスのサブシーケンスであるCharSequenceを返します。 部分列は、指定された索引のchar値で始まり、索引end - 1のchar値で終わります。 返される� �序の長さ(in char s)はend - startであるため、start == endの� �合は空の� �序が返されます。

パラメータ:

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

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

戻り値:

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

スロー:

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

toString

String toString()

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

オーバーライド:

toString、クラスObject

戻り値:

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

chars

default IntStream chars()

このシーケンスのchar値をゼロ拡張したintを含むストリー� を返します。 サロゲート・コード・ポイントにマップするすべてのcharは、解釈されずに渡されます。

ストリー� は、ターミナル・ストリー� 操作が(特に、可変� �序の� �合、ストリー� のスプリッタはlate-bindingです)で始まるときにこのシーケンスにバインドされます。 その操作中に� �序が変更された� �合、結果は未定義です。

戻り値:

このシーケンスのchar値のIntStream

導入されたバージョン:

1.8

codePoints

default IntStream codePoints()

このシーケンスからコード・ポイント値のストリー� を返します。 そのシーケンスで検出されるサロゲート・ペアがすべて、Character.toCodePointを使用した� �合のように結合され、結果がストリー� に渡されます。 他のすべてのコード(通常のBMP文字、ペアになっていないサロゲート、未定義のコード単位など)はint値にゼロ拡張されたあと、ストリー� に渡されます。

ストリー� は、ターミナル・ストリー� 操作が(特に、可変� �序の� �合、ストリー� のスプリッタはlate-bindingです)で始まるときにこのシーケンスにバインドされます。 その操作中に� �序が変更された� �合、結果は未定義です。

戻り値:

このシーケンスからのUnicodeコード・ポイントのIntStream

導入されたバージョン:

1.8

compare

static int compare(CharSequence cs1, CharSequence cs2)

2つのCharSequenceインスタンスを辞書的に比較します。 最初の� �序が辞書的に小さい� �合、等しい� �合、または2番目の値以上の� �合は、それぞれ� の値のゼロまたは正の値を返します。

CharSequenceの辞書的な� �序付けは、次のように定義されています。 たとえば、CharSequence csの長さがlenで、文字値の� �序が[0]からcs [len-1]であるとします。 kが、各� �序の対応する文字値が異なる最低の索引であるとします。 � �序の辞書的な� �序付けは、cs1 [k]とcs2 [k]の文字値の数値比較によって決まります。 このような索引kがない� �合、短い� �序は辞書的に小さいとみなされます。 � �序の長さが同じ� �合、� �序は辞書的に同等とみなされます。

パラメータ:

cs1 - 最初のCharSequence

cs2 - 2番目のCharSequence

戻り値:

2つのCharSequenceが等しい� �合は0、最初のCharSequenceが辞書的に2番目より小さい� �合は� の整数、最初のCharSequenceが辞書的に2番目の文字より大きい� �合は正の整数。

導入されたバージョン:

11