Перечисление 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"` не является допустимым базовым диапазоном языка.

C момента:

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, 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/util/Locale.FilteringMode.html