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

クラスSegment

java.lang.Object
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
    目的のテキストが始まる配列へのオフセットです。

    インタフェース java.text.CharacterIteratorで宣言されたフィールド

    DONE

  • コンストラクタのサマリー

    コンストラクタ 
    コンストラクタ 説明
    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()
    セグメントを文字列に変換します。

    クラス java.lang.Objectで宣言されたメソッド

    equals、finalize、getClass、hashCode、notify、notifyAll、wait、wait、wait

    インタフェース java.lang.CharSequenceで宣言されたメソッド

    chars, codePoints

  • フィールド詳細

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

    • clone

      public Object clone()
      シャロー・コピーを作成します。
      定義:
      clone、インタフェース: CharacterIterator
      オーバーライド:
      clone、クラス: Object
      戻り値:
      コピー
      関連項目:
      Cloneable