Перечисление 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 Matching of Language Tags.

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

    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

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

См. также:

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

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

Enum.EnumDesc<E extends Enum<E>>

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

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

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

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

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

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

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

getClass, notify, notifyAll, wait, wait, wait

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

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/Locale.FilteringMode.html