java.text

インタフェース AttributedCharacterIterator

すべてのスーパーインタフェース:

CharacterIterator, Cloneable

public interface AttributedCharacterIterator
extends CharacterIterator

AttributedCharacterIterator は、テキストとそのテキストに関連する属性情報を、どちらも反復処理できるようにします。

属性はキーと値のペアであり、キーで識別されます。1 つの文字に対して複数の属性キーを定義することはできません。

属性の値は不変です。つまり、クライアントやストレージによって変更できません。属性の値は常に参照渡しです。複製されることはありません。

次の場合、属性についてのランは、最大テキスト範囲です。

• 属性が範囲全体に対して未定義または null である、あるいは
• 属性値が定義され、範囲全体に対して null 以外の同じ値を持つ。

属性セットについてのランは、それぞれのメンバー属性について上記の条件が成立する最大テキスト範囲です。

明示的な属性を指定せずにランを取得すると (すなわち、getRunStart() および getRunLimit() を呼び出すと)、同じ属性 (同じ属性/値ペアセット) を持つ連続したテキストセグメントは、属性がそれらのテキストセグメントに個別に与えられている場合、別個のランとして扱われます。

返されるインデックスは、イテレータの範囲に限定されます。

返される属性情報は、現在の文字を保持するランに限定されます。

属性キーは、AttributedCharacterIterator.Attribute およびそのサブクラス (TextAttribute など) のインスタンスです。

導入されたバージョン:

1.2

関連項目:

AttributedCharacterIterator.Attribute, TextAttribute, AttributedString, Annotation

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	インタフェースと説明
static class	AttributedCharacterIterator.Attribute テキスト属性の識別に使用する属性キーを定義します。

フィールドのサマリー

インタフェース java.text.CharacterIterator から継承されたフィールド

DONE

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Set<AttributedCharacterIterator.Attribute>	getAllAttributeKeys() イテレータのテキスト範囲で定義されたすべての属性のキーを返します。
Object	getAttribute(AttributedCharacterIterator.Attribute attribute) 現在の文字について指定された attribute の値を返します。
Map<AttributedCharacterIterator.Attribute,Object>	getAttributes() 現在の文字に定義された属性を持つマップを返します。
int	getRunLimit() 現在の文字を保持するすべての属性について、ランの次に来る先頭文字のインデックスを返します。
int	getRunLimit(AttributedCharacterIterator.Attribute attribute) 現在の文字を保持する指定された attribute について、ランの次に来る先頭文字のインデックスを返します。
int	getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes) 現在の文字を保持する指定された attributes について、ランの次に来る先頭文字のインデックスを返します。
int	getRunStart() 現在の文字を保持するすべての属性について、ランの先頭文字のインデックスを返します。
int	getRunStart(AttributedCharacterIterator.Attribute attribute) 現在の文字を保持する指定された attribute について、ランの先頭文字のインデックスを返します。
int	getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes) 現在の文字を保持する指定された attributes について、ランの先頭文字のインデックスを返します。

インタフェース java.text.CharacterIterator から継承されたメソッド

clone, current, first, getBeginIndex, getEndIndex, getIndex, last, next, previous, setIndex

メソッドの詳細

getRunStart

int getRunStart()

現在の文字を保持するすべての属性について、ランの先頭文字のインデックスを返します。

同じ属性 (同じ属性/値ペアセット) を持つ連続したテキストセグメントは、属性がそれらのテキストセグメントに個別に与えられている場合、別個のランとして扱われます。

getRunStart

int getRunStart(AttributedCharacterIterator.Attribute attribute)

現在の文字を保持する指定された attribute について、ランの先頭文字のインデックスを返します。

getRunStart

int getRunStart(Set<? extends AttributedCharacterIterator.Attribute> attributes)

現在の文字を保持する指定された attributes について、ランの先頭文字のインデックスを返します。

getRunLimit

int getRunLimit()

現在の文字を保持するすべての属性について、ランの次に来る先頭文字のインデックスを返します。

同じ属性 (同じ属性/値ペアセット) を持つ連続したテキストセグメントは、属性がそれらのテキストセグメントに個別に与えられている場合、別個のランとして扱われます。

getRunLimit

int getRunLimit(AttributedCharacterIterator.Attribute attribute)

現在の文字を保持する指定された attribute について、ランの次に来る先頭文字のインデックスを返します。

getRunLimit

int getRunLimit(Set<? extends AttributedCharacterIterator.Attribute> attributes)

現在の文字を保持する指定された attributes について、ランの次に来る先頭文字のインデックスを返します。

getAttributes

Map<AttributedCharacterIterator.Attribute,Object> getAttributes()

現在の文字に定義された属性を持つマップを返します。

getAttribute

Object getAttribute(AttributedCharacterIterator.Attribute attribute)

現在の文字について指定された attribute の値を返します。attribute が定義されていない場合は null を返します。

getAllAttributeKeys

Set<AttributedCharacterIterator.Attribute> getAllAttributeKeys()

イテレータのテキスト範囲で定義されたすべての属性のキーを返します。属性が定義されていない場合、セットは空です。