モジュール java.desktop
パッケージ javax.swing.text

クラスSegment

  • すべての実装されたインタフェース:
    CharSequence, Cloneable, CharacterIterator

    public class Segment
    extends Object
    implements Cloneable, CharacterIterator, CharSequence
    テキストのフラグメントを表す文字配列のセグメントです。 配列に直接アクセスできても、セグメントを変更しないでください。 文字をコピーするオーバーヘッドのない、テキストのフラグメントに速くアクセスできます。 事実上、保護されていない文字列です。

    Segmentは、テキストを文字列にコピーせずに国際化(i18n)サポートの使用を提供するためにjava.text.CharacterIteratorインタフェースを実装します。

    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      char[] array
      処理対象のテキストを含む配列です。
      int count
      処理対象のテキストを構成する配列要素の数です。
      int offset
      目的のテキストが始まる配列へのオフセットです。
    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      Segment()
      新しいセグメントを作成します。
      Segment​(char[] array, int offset, int count)
      既存の配列を参照する新しいセグメントを作成します。
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      char charAt​(int index)
      指定されたインデックスのchar値を返します。
      Object clone()
      シャロー・コピーを作成します。
      char current()
      現在位置(getIndex()によって返される位置)にある文字を取得します。
      char first()
      位置をgetBeginIndex()に設定して、その位置にある文字を返します。
      int getBeginIndex()
      テキストの開始インデックスを返します。
      int getEndIndex()
      テキストの終了インデックスを返します。
      int getIndex()
      現在のインデックスを返します。
      boolean isPartialReturn()
      部分的戻り値が有効であることを表すフラグです。
      char last()
      位置をgetEndIndex()-1 (テキストが空の場合はgetEndIndex())に設定して、その位置にある文字を返します。
      int length()
      この文字シーケンスの長さを返します。
      char next()
      イテレータのインデックスを1増やし、新しいインデックスにある文字を返します。
      char previous()
      イテレータのインデックスを1減らし、新しいインデックスにある文字を返します。
      char setIndex​(int position)
      位置を指定されたテキストの位置に設定して、その文字を返します。
      void setPartialReturn​(boolean p)
      部分的戻り値が有効であることを表すフラグです。
      CharSequence subSequence​(int start, int end)
      このシーケンスのサブシーケンスであるCharSequenceを返します。
      String toString()
      セグメントを文字列に変換します。
    • フィールドの詳細

      • array

        public char[] array
        処理対象のテキストを含む配列です。 この配列は変更しないでください。効率を向上させるためだけに使用されます。
      • offset

        public int offset
        目的のテキストが始まる配列へのオフセットです。
      • count

        public int count
        処理対象のテキストを構成する配列要素の数です。
    • コンストラクタの詳細

      • Segment

        public Segment()
        新しいセグメントを作成します。
      • Segment

        public Segment​(char[] array,
                       int offset,
                       int count)
        既存の配列を参照する新しいセグメントを作成します。
        パラメータ:
        array - 参照する配列
        offset - 配列へのオフセット
        count - 文字数
    • メソッドの詳細

      • setPartialReturn

        public void setPartialReturn​(boolean p)
        部分的戻り値が有効であることを表すフラグです。 フラグがtrueの場合、インタフェース・メソッドDocument.getText(position,length,Segment)の実装では、コピーを作らずに可能な限り多くのテキストが返されるはずです。 フラグのデフォルトの状態はfalseで、Document.getText(position,length,Segment)に常に同じ戻り動作を行わせます。これは要求によってテキストを複製する場合としない場合があります。
        パラメータ:
        p - 部分的戻り値が有効かどうか。
        導入されたバージョン:
        1.4
      • isPartialReturn

        public boolean isPartialReturn()
        部分的戻り値が有効であることを表すフラグです。
        戻り値:
        部分的戻り値が有効かどうか。
        導入されたバージョン:
        1.4
      • toString

        public String toString()
        セグメントを文字列に変換します。
        定義:
        toString、インタフェースCharSequence
        オーバーライド:
        toString、クラスObject
        戻り値:
        文字列
      • first

        public char first()
        位置をgetBeginIndex()に設定して、その位置にある文字を返します。
        定義:
        first、インタフェースCharacterIterator
        戻り値:
        テキスト内の先頭文字。テキストが空の場合はDONE
        導入されたバージョン:
        1.3
        関連項目:
        getBeginIndex()
      • last

        public char last()
        位置をgetEndIndex()-1 (テキストが空の場合はgetEndIndex())に設定して、その位置にある文字を返します。
        定義:
        last、インタフェースCharacterIterator
        戻り値:
        テキスト内の最後の文字。テキストが空の場合はDONE
        導入されたバージョン:
        1.3
        関連項目:
        getEndIndex()
      • current

        public char current()
        現在位置(getIndex()によって返される位置)にある文字を取得します。
        定義:
        current、インタフェースCharacterIterator
        戻り値:
        現在位置にある文字。現在位置がテキストの終わりを過ぎている場合はDONE。
        導入されたバージョン:
        1.3
        関連項目:
        getIndex()
      • next

        public char next()
        イテレータのインデックスを1増やし、新しいインデックスにある文字を返します。 結果のインデックスがgetEndIndex()より大きいか、それに等しい場合、現在のインデックスがgetEndIndex()にリセットされ、値DONEが返されます。
        定義:
        next、インタフェースCharacterIterator
        戻り値:
        新しい位置にある文字。新しい位置がテキスト範囲の終わりを過ぎている場合はDONE。
        導入されたバージョン:
        1.3
      • previous

        public char previous()
        イテレータのインデックスを1減らし、新しいインデックスにある文字を返します。 現在のインデックスがgetBeginIndex()の場合、インデックスはgetBeginIndex()のまま変わらず、値DONEが返されます。
        定義:
        previous、インタフェースCharacterIterator
        戻り値:
        新しい位置にある文字。現在の位置がgetBeginIndex()に等しい場合はDONE。
        導入されたバージョン:
        1.3
      • setIndex

        public char setIndex​(int position)
        位置を指定されたテキストの位置に設定して、その文字を返します。
        定義:
        setIndex、インタフェースCharacterIterator
        パラメータ:
        position - テキスト内の位置。 有効な値は、getBeginIndex()からgetEndIndex()。 無効な値を指定すると、IllegalArgumentExceptionがスローされる。
        戻り値:
        指定された位置にある文字。指定された位置がgetEndIndex()に等しい場合はDONE
        導入されたバージョン:
        1.3
      • getBeginIndex

        public int getBeginIndex()
        テキストの開始インデックスを返します。
        定義:
        getBeginIndex、インタフェースCharacterIterator
        戻り値:
        テキストが始まる位置のインデックス。
        導入されたバージョン:
        1.3
      • getEndIndex

        public int getEndIndex()
        テキストの終了インデックスを返します。 このインデックスは、テキストの終わりの次の文字のインデックスです。
        定義:
        getEndIndex、インタフェースCharacterIterator
        戻り値:
        テキスト内の最後の文字の次のインデックス
        導入されたバージョン:
        1.3
      • getIndex

        public int getIndex()
        現在のインデックスを返します。
        定義:
        getIndex、インタフェースCharacterIterator
        戻り値:
        現在のインデックス。
        導入されたバージョン:
        1.3
      • charAt

        public char charAt​(int index)
        指定されたインデックスのchar値を返します。 インデックスは、0からlength() - 1の範囲になります。 配列のインデックス付けの場合と同じように、シーケンスの最初のcharのインデックスは0、次の文字のインデックスは1と続きます。

        インデックスで指定されたchar値がサロゲートの場合、サロゲート値が返されます。

        定義:
        charAt、インタフェースCharSequence
        パラメータ:
        index - 返されるchar値のインデックス
        戻り値:
        指定されたchar
        導入されたバージョン:
        1.6
      • length

        public int length()
        この文字シーケンスの長さを返します。 長さはシーケンス内の16ビットcharの数に等しくなります。
        定義:
        length、インタフェースCharSequence
        戻り値:
        このシーケンスのcharの数
        導入されたバージョン:
        1.6
      • subSequence

        public CharSequence subSequence​(int start,
                                        int end)
        このシーケンスのサブシーケンスであるCharSequenceを返します。 サブシーケンスは、指定されたインデックスのchar値で始まり、インデックスend - 1char値で終わります。 返される(charの)シーケンスの長さはend - startです。このため、start == endの場合、空のシーケンスが返されます。
        定義:
        subSequence、インタフェースCharSequence
        パラメータ:
        start - 開始インデックス(この値を含む)
        end - 終了インデックス(この値を含まない)
        戻り値:
        指定されたサブシーケンス
        導入されたバージョン:
        1.6