-
- 既知のすべてのサブインタフェース:
Name
- 既知のすべての実装クラス:
CharBuffer,Segment,String,StringBuffer,StringBuilder
public interface CharSequenceCharSequenceはchar値の読取り可能なシーケンスです。 このインタフェースは、さまざまな種類のcharシーケンスへの統一された読取り専用アクセスを提供します。char値は、基本多言語面(BMP)またはサロゲートの文字を表します。 詳細は、Unicode文字表現を参照してください。このインタフェースは、
equalsメソッドとhashCodeメソッドの汎用規約を洗練させるものではありません。 このため、CharSequenceを実装する2つのオブジェクトの比較結果は、通常、定義されていません。 各オブジェクトを異なるクラスを使用して実装できるため、各クラスがそのインスタンスをほかのクラスのインスタンスと等価かどうか検査できるという保証はありません。 したがって、セットの要素としてまたはマップのキーとして、任意のCharSequenceインスタンスを使うのは不適切です。- 導入されたバージョン:
- 1.4
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド デフォルト・メソッド 修飾子と型 メソッド 説明 charcharAt(int index)指定されたインデックスのchar値を返します。default IntStreamchars()このシーケンスのchar値をゼロ拡張したintを含むストリームを返します。default IntStreamcodePoints()このシーケンスからコード・ポイント値のストリームを返します。intlength()この文字シーケンスの長さを返します。CharSequencesubSequence(int start, int end)このシーケンスのサブシーケンスであるCharSequenceを返します。StringtoString()このシーケンス内の文字を含む文字列を、このシーケンスと同じ順序で返します。
-
-
-
メソッドの詳細
-
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
-
-