モジュール 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

外部仕様

• RFC 4647: 言語タグの一致

関連項目:

• 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)	指定された名前を持つこのクラスのenum定数を返します。
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)

指定された名前を持つこのクラスのenum定数を返します。 文字列は、このクラスでenum定数を宣言するために使用される識別子と正確に一致する必要があります。 (不適切な空白文字は許可されません。)

パラメータ:

name - 返される列挙型定数の名前。

戻り値:

指定された名前を持つ列挙型定数

例外:

IllegalArgumentException - この列挙型クラスに指定された名前の定数がない場合

NullPointerException - 引数がnullの場合