compact1、compact2、compact3

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値を返します。
default IntStream	chars() このシーケンスのchar値をゼロ拡張したintを含むストリームを返します。
default IntStream	codePoints() このシーケンスからコード・ポイント値のストリームを返します。
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

戻り値:

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

chars

default IntStream chars()

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

ストリームの読取り中にシーケンスが変更される場合、結果は未定義です。

戻り値:

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

導入されたバージョン:

1.8

codePoints

default IntStream codePoints()

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

ストリームの読取り中にシーケンスが変更される場合、結果は未定義です。

戻り値:

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

導入されたバージョン:

1.8