Класс перечисления 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>

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

Константа перечисления	Описание
`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

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/Locale.FilteringMode.html