Класс FieldPosition

public class FieldPosition
extends Object

FieldPosition — это простой класс, используемый Format и его подклассами для идентификации полей в отформатированном выводе. Поля могут быть идентифицированы двумя способами:

• По целочисленной константе, имена которых обычно заканчиваются на _FIELD. Константы определены в различных подклассах Format.
• По константе Format.Field, см. ERA_FIELD и её аналоги в DateFormat для примера.

FieldPosition отслеживает позицию поля в отформатированном выводе с помощью двух индексов: индекса первого символа поля и индекса последнего символа поля.

Один из вариантов метода format в различных классах Format требует объекта FieldPosition в качестве аргумента. Вы используете этот метод format для частичного форматирования или получения информации об отформатированном выводе (например, о позиции поля).

Если вас интересуют позиции всех атрибутов в отформатированной строке, используйте метод Format formatToCharacterIterator.

Подробное описание конструкторов

FieldPosition

public FieldPosition(int field)

Создаёт объект FieldPosition для заданного поля. Поля идентифицируются константами, имена которых обычно заканчиваются на _FIELD, в различных подклассах Format.

Параметры:

field - идентификатор поля

См. также:

NumberFormat.INTEGER_FIELD, NumberFormat.FRACTION_FIELD, DateFormat.YEAR_FIELD, DateFormat.MONTH_FIELD

FieldPosition

public FieldPosition(Format.Field attribute)

Создаёт объект FieldPosition для заданной константы поля. Поля идентифицируются константами, определёнными в различных подклассах Format. Это эквивалентно вызову new FieldPosition(attribute, -1).

Параметры:

attribute - константа Format.Field, идентифицирующая поле

С:

1.4

FieldPosition

public FieldPosition(Format.Field attribute,
                     int fieldID)

Создаёт объект FieldPosition для заданного поля. Поле идентифицируется константой атрибута из одного из подклассов Field, а также целым идентификатором поля, определённым подклассами Format. Подклассы Format, которые осведомлены о Field, должны отдавать приоритет attribute и игнорировать fieldID если attribute не равен null. Однако более старые подклассы Format могут не знать о Field и полагаться на fieldID. Если для поля нет соответствующей целочисленной константы, fieldID должно быть -1.

Параметры:

attribute - константа Format.Field, идентифицирующая поле

fieldID - целочисленная константа, идентифицирующая поле

С:

1.4

Подробное описание методов

getFieldAttribute

public Format.Field getFieldAttribute()

Возвращает идентификатор поля как константу атрибута из одного из подклассов Field . Может вернуть null, если поле задано только целочисленным идентификатором поля.

Возвращает:

Идентификатор поля

С:

1.4

getField

public int getField()

Возвращает идентификатор поля.

Возвращает:

идентификатор поля

getBeginIndex

public int getBeginIndex()

Возвращает индекс первого символа в запрошенном поле.

Возвращает:

начальный индекс

getEndIndex

public int getEndIndex()

Возвращает индекс символа, следующего за последним символом в запрошенном поле.

Возвращает:

конечный индекс

setBeginIndex

public void setBeginIndex(int bi)

Устанавливает начальный индекс. Для использования подклассами Format.

Параметры:

bi - начальный индекс

С:

1.2

setEndIndex

public void setEndIndex(int ei)

Устанавливает конечный индекс. Для использования подклассами Format.

Параметры:

ei - конечный индекс

С:

1.2

equals

public boolean equals(Object obj)

Переопределяет equals

Переопределяет:

equals в классе Object

Параметры:

obj - объект-ссылка для сравнения.

Возвращает:

true если этот объект такой же, как аргумент obj; false в противном случае.

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает хэш-код для этого FieldPosition.

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

Возвращает строковое представление этого FieldPosition.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого объекта