モジュール java.base
パッケージ java.lang

インタフェースCharSequence

  • 既知のすべてのサブインタフェース:
    Name
    既知のすべての実装クラス:
    CharBuffer, Segment, String, StringBuffer, StringBuilder


    public interface CharSequence
    CharSequencechar値の読取り可能なシーケンスです。 このインタフェースは、さまざまな種類の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 - 1char値で終わります。 返される(charの)シーケンスの長さはend - startです。このため、start == endの場合、空のシーケンスが返されます。
        パラメータ:
        start - 開始インデックス(この値を含む)
        end - 終了インデックス(この値を含まない)
        戻り値:
        指定されたサブシーケンス
        例外:
        IndexOutOfBoundsException - startまたはendが負の値の場合、endlength()よりも大きい場合、あるいはstartendよりも大きい場合
      • 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