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

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

Постоянные значения перечисления

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()

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

for (Locale.FilteringMode c : Locale.FilteringMode.values())
    System.out.println(c);

Возвращает:

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

valueOf

public static Locale.FilteringMode valueOf(String name)

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

Параметры:

name - имя возвращаемой константы перечисления.

Возвращает:

константа перечисления с указанным именем

Исключения:

IllegalArgumentException - если в этом типе перечисления нет константы с указанным именем

NullPointerException - если аргумент равен null