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

Возвращает:

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

См. также:

toString

public String toString()

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

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

© 1993, 2023, 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/21/docs/api/java.base/java/text/FieldPosition.html