モジュール 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 Matching of Language Tags」を参照してください。

たとえば、2つの言語優先度リストがあり、それぞれに言語範囲が1つのみ、および以下の言語タグ・セットが含まれるとします。 

    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"にマップされているため"de-DE"と"de-DE-1996"を返します。
REJECT_EXTENDED_RANGES 上記と同じです。 "de-*-DE"は有効な基本言語範囲でないため、IllegalArgumentExceptionをスローします。

導入されたバージョン:
1.8
関連項目:
Locale.filter(List, Collection, FilteringMode)、Locale.filterTags(List, Collection, FilteringMode)

  • ネストされたクラスのサマリー

    クラス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の場合