モジュール 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, isEmpty

フィールド詳細

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値で終わります。 返される順序の長さ(in char s)はend - startであるため、start == endの場合は空の順序が返されます。

定義:

subSequence、インタフェースCharSequence

パラメータ:

start - 開始インデックス(この値を含む)

end - 終了インデックス(この値を含まない)

戻り値:

指定されたサブシーケンス

導入されたバージョン:

1.6

clone

public Object clone()

シャロー・コピーを作成します。

定義:

clone、インタフェースCharacterIterator

オーバーライド:

clone、クラスObject

戻り値:

コピー

関連項目:

• Cloneable