Перечисление Locale.FilteringMode

java.lang.Object

java.lang.Enum<Locale.FilteringMode>

java.util.Locale.FilteringMode

Все реализуемые интерфейсы:: Serializable, Comparable<Locale.FilteringMode>, Constable

Внешний класс:: Locale

public static enum Locale.FilteringMode extends Enum<Locale.FilteringMode>

Это перечисление предоставляет константы для выбора режима фильтрации при сопоставлении локалей. Подробнее см. в документе RFC 4647 «Сопоставление языковых тегов».

Рассмотрим для примера два списка приоритетов языков, каждый из которых содержит только один языковой диапазон, а также набор следующих языковых тегов:

   de (German)
   de-DE (German, Germany)
   de-Deva (German, in Devanagari script)
   de-Deva-DE (German, in Devanagari script, Germany)
   de-DE-1996 (German, Germany, orthography of 1996)
   de-Latn-DE (German, in Latin script, Germany)
   de-Latn-DE-1996 (German, in Latin script, Germany, orthography of 1996)

Метод фильтрации будет работать следующим образом:

Поведение метода фильтрации
Режим фильтрации	Список приоритетов языков: `"de-DE"`	Список приоритетов языков: `"de-*-DE"`
`AUTOSELECT_FILTERING`	Выполняет базовую фильтрацию и возвращает `"de-DE"` и `"de-DE-1996"`.	Выполняет расширенную фильтрацию и возвращает `"de-DE"`, `"de-Deva-DE"`, `"de-DE-1996"`, `"de-Latn-DE"` и `"de-Latn-DE-1996"`.
`EXTENDED_FILTERING`	Выполняет расширенную фильтрацию и возвращает `"de-DE"`, `"de-Deva-DE"`, `"de-DE-1996"`, `"de-Latn-DE"` и `"de-Latn-DE-1996"`.	То же, что и выше.
`IGNORE_EXTENDED_RANGES`	Выполняет базовую фильтрацию и возвращает `"de-DE"` и `"de-DE-1996"`.	Выполняет базовую фильтрацию и возвращает `null`, поскольку совпадений нет.
`MAP_EXTENDED_RANGES`	То же, что и выше.	Выполняет базовую фильтрацию и возвращает `"de-DE"` и `"de-DE-1996"`, поскольку `"de-*-DE"` сопоставляется с `"de-DE"`.
`REJECT_EXTENDED_RANGES`	То же, что и выше.	Выбрасывает `IllegalArgumentException`, поскольку `"de-*-DE"` не является допустимым базовым языковым диапазоном.

С версии:

1.8

Внешние спецификации

См. также:

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>

Модификатор и тип	Класс	Описание
`static final class`	`Enum.EnumDesc<E extends Enum<E>>`	Номинальный дескриптор для константы `enum`.

Краткое описание констант перечисления

Константа перечисления	Описание
`AUTOSELECT_FILTERING`	Задает автоматический режим фильтрации на основе заданного списка приоритетов языков, состоящего из языковых диапазонов.
`EXTENDED_FILTERING`	Задает расширенную фильтрацию.
`IGNORE_EXTENDED_RANGES`	Задает базовую фильтрацию. Обратите внимание, что все расширенные языковые диапазоны, включенные в заданный список приоритетов языков, игнорируются.
`MAP_EXTENDED_RANGES`	Задает базовую фильтрацию. Если в заданный список приоритетов языков включены расширенные языковые диапазоны, они преобразуются в базовые языковые диапазоны.
`REJECT_EXTENDED_RANGES`	Задает базовую фильтрацию. Если в заданный список приоритетов языков включены расширенные языковые диапазоны, список отклоняется, а метод фильтрации выбрасывает `IllegalArgumentException`.

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

Модификатор и тип	Метод	Описание
`static Locale.FilteringMode`	`valueOf(String name)`	Возвращает константу перечисления этого класса с указанным именем.
`static Locale.FilteringMode[]`	`values()`	Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

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

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Модификатор и тип	Метод	Описание
`protected final Object`	`clone()`	Выбрасывает CloneNotSupportedException.
`final int`	`compareTo(Locale.FilteringMode o)`	Сравнивает это перечисление с указанным объектом, определяя порядок.
`final Optional<Enum.EnumDesc<Locale.FilteringMode>>`	`describeConstable()`	Возвращает дескриптор перечисления `EnumDesc` для этого экземпляра, если его можно создать, или пустой объект `Optional`, если создать его нельзя.
`final boolean`	`equals(Object other)`	Возвращает true, если указанный объект равен этой константе перечисления.
`protected final void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Метод finalize() признан устаревшим и подлежит удалению.
`final Class<Locale.FilteringMode>`	`getDeclaringClass()`	Возвращает объект Class, соответствующий типу перечисления этой константы перечисления.
`final int`	`hashCode()`	Возвращает хеш-код этой константы перечисления.
`final String`	`name()`	Возвращает имя этой константы перечисления точно в том виде, в котором оно указано в объявлении перечисления.
`final int`	`ordinal()`	Возвращает порядковый номер этой константы перечисления (ее позицию в объявлении перечисления, где первой константе присваивается порядковый номер ноль).
`String`	`toString()`	Возвращает имя этой константы перечисления, указанное в объявлении.
`static <T extends Enum<T>> T`	`valueOf(Class<T> enumClass, String name)`	Возвращает константу указанного класса перечисления с указанным именем.

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

getClass, notify, notifyAll, wait, wait, wait

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

Подробное описание констант перечисления

AUTOSELECT_FILTERING

public static final Locale.FilteringMode AUTOSELECT_FILTERING

Задает автоматический режим фильтрации на основе заданного списка приоритетов языков, состоящего из языковых диапазонов. Если все диапазоны являются базовыми, выбирается базовая фильтрация. В противном случае выбирается расширенная фильтрация.

EXTENDED_FILTERING

public static final Locale.FilteringMode EXTENDED_FILTERING

Задает расширенную фильтрацию.

IGNORE_EXTENDED_RANGES

public static final Locale.FilteringMode IGNORE_EXTENDED_RANGES

Задает базовую фильтрацию. Обратите внимание, что все расширенные языковые диапазоны, включенные в заданный список приоритетов языков, игнорируются.

MAP_EXTENDED_RANGES

public static final Locale.FilteringMode MAP_EXTENDED_RANGES

Задает базовую фильтрацию. Если в заданный список приоритетов языков включены расширенные языковые диапазоны, они преобразуются в базовые языковые диапазоны. В частности, языковой диапазон, начинающийся с подстановочного тега "*", рассматривается как языковой диапазон "*". Например, "*-US" рассматривается как "*". Если "*" не является первым тегом, "*" и дополнительные "-" удаляются. Например, "ja-*-JP" преобразуется в "ja-JP".

REJECT_EXTENDED_RANGES

public static final Locale.FilteringMode REJECT_EXTENDED_RANGES

Задает базовую фильтрацию. Если в заданный список приоритетов языков включены расширенные языковые диапазоны, список отклоняется, а метод фильтрации выбрасывает IllegalArgumentException.

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

values

public static Locale.FilteringMode[] values()

Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

Возвращает:: массив, содержащий константы этого класса перечисления в порядке их объявления

valueOf

public static Locale.FilteringMode valueOf(String name)

Возвращает константу перечисления этого класса с указанным именем. Строка должна точно совпадать с идентификатором, используемым для объявления константы перечисления в этом классе. (Пробелы в начале и конце строки не допускаются.)

Параметры:: name — имя возвращаемой константы перечисления.
Возвращает:: константу перечисления с указанным именем
Выбрасывает:: IllegalArgumentException — если в этом классе перечисления нет константы с указанным именем; NullPointerException — если аргумент равен null

© 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.