Класс 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.

Начиная с версии:

1.1

См. также:

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

Конструктор	Описание
`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.

Методы, объявленные в классе Object

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

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

FieldPosition

public FieldPosition(int field)

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

Параметры:

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.

См. также:

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

хеш-код этого объекта FieldPosition

См. также:

toString

public String toString()

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

Переопределяет:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/FieldPosition.html