Класс FieldPosition

java.lang.Object

java.text.FieldPosition

public class FieldPosition extends Object

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

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

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

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

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

Since:

1.1

See Also:

Краткое описание конструкторов

Конструктор	Описание
`FieldPosition(int field)`	Создаёт объект FieldPosition для заданного поля.
`FieldPosition(Format.Field attribute)`	Создаёт объект FieldPosition для заданной константы поля.
`FieldPosition(Format.Field attribute, int fieldID)`	Создаёт объект `FieldPosition` для заданного поля.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Переопределяет equals
`int`	`getBeginIndex()`	Возвращает индекс первого символа в запрошенном поле.
`int`	`getEndIndex()`	Возвращает индекс символа, следующего за последним символом в запрошенном поле.
`int`	`getField()`	Возвращает идентификатор поля.
`Format.Field`	`getFieldAttribute()`	Возвращает идентификатор поля как константу атрибута из одного из подклассов `Field`.
`int`	`hashCode()`	Возвращает хэш-код для этого FieldPosition.
`void`	`setBeginIndex(int bi)`	Устанавливает начальный индекс.
`void`	`setEndIndex(int ei)`	Устанавливает конечный индекс.
`String`	`toString()`	Возвращает строковое представление этого FieldPosition.

Методы, унаследованные от класса java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

FieldPosition

public FieldPosition(int field)

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

Параметры:

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

См. также:

FieldPosition

public FieldPosition(Format.Field attribute)

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

Параметры:: attribute — константа Format.Field, идентифицирующая поле
Since:: 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 — целочисленная константа, идентифицирующая поле
Since:: 1.4

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

getFieldAttribute

public Format.Field getFieldAttribute()

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

Возвращает:: Идентификатор поля
Since:: 1.4

getField

public int getField()

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

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

getBeginIndex

public int getBeginIndex()

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

Возвращает:: начальный индекс

getEndIndex

public int getEndIndex()

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

Возвращает:: конечный индекс

setBeginIndex

public void setBeginIndex(int bi)

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

Параметры:: bi — начальный индекс
Since:: 1.2

setEndIndex

public void setEndIndex(int ei)

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

Параметры:: ei — конечный индекс
Since:: 1.2

equals

public boolean equals(Object obj)

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

Overrides:

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

hashCode

public int hashCode()

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

Overrides:

hashCode в классе Object

Возвращает:

хэш-код для этого FieldPosition

См. также:

toString

public String toString()

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

Overrides:: toString в классе Object
Возвращает:: строковое представление этого объекта

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/text/FieldPosition.html