-
- 既知のすべてのサブインタフェース:
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()
このシーケンス内の文字を含む文字列を、このシーケンスと同じ順序で返します。 このシーケンスの長さが、文字列の長さになります。
-
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
-
-