模块 java.base
包 java.util

枚举类枚举类 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 执行 basic 过滤并返回 "de-DE" 和 "de-DE-1996" 。 执行 extended 过滤并返回 "de-DE"、"de-Deva-DE"、"de-DE-1996"、"de-Latn-DE" 和 "de-Latn-DE-1996"。
EXTENDED_FILTERING 执行 extended 过滤并返回 "de-DE"、"de-Deva-DE"、"de-DE-1996"、"de-Latn-DE" 和 "de-Latn-DE-1996"。 同上。
IGNORE_EXTENDED_RANGES 执行 basic 过滤并返回 "de-DE" 和 "de-DE-1996" 。 执行 basic 过滤并返回 null 因为没有匹配项。
MAP_EXTENDED_RANGES 同上。 执行 basic 过滤并返回 "de-DE" 和 "de-DE-1996" 因为 "de-*-DE" 映射到 "de-DE" 。
REJECT_EXTENDED_RANGES 同上。 抛出 IllegalArgumentException 因为 "de-*-DE" 不是有效的基本语言范围。
自从：
1.8
参见：

  • 枚举常量详细信息

    • 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 - 如果参数为空