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

java.lang.Object
- java.lang.Enum<Locale.FilteringMode>
- - java.util.Locale.FilteringMode

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

Вложенный класс:: 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
См. также:: Locale.filter(List, Collection, FilteringMode), Locale.filterTags(List, Collection, FilteringMode)

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

Постоянное значение перечисления	Описание
`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, 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()

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

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

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

valueOf

public static Locale.FilteringMode valueOf(String name)

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

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