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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API планируется удалить в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

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

FieldPosition

public FieldPosition(int field)

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

Параметры:

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.