Locale.FilteringMode Class

Definition

This enum provides constants to select a filtering mode for locale matching.

[Android.Runtime.Register("java/util/Locale$FilteringMode", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Locale.FilteringMode : Java.Lang.Enum
[<Android.Runtime.Register("java/util/Locale$FilteringMode", ApiSince=26, DoNotGenerateAcw=true)>]
type Locale.FilteringMode = class
    inherit Enum
Inheritance
Locale.FilteringMode
Attributes

Remarks

This enum provides constants to select a filtering mode for locale matching. Refer to RFC 4647 Matching of Language Tags for details.

As an example, think of two Language Priority Lists each of which includes only one language range and a set of following language tags:

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)

The filtering method will behave as follows:

<table class="striped"> <caption>Filtering method behavior</caption> <thead> <tr> <th scope="col">Filtering Mode</th> <th scope="col">Language Priority List: "de-DE"</th> <th scope="col">Language Priority List: "de-*-DE"</th> </tr> </thead> <tbody> <tr> <th scope="row" style="vertical-align:top"> FilteringMode#AUTOSELECT_FILTERING AUTOSELECT_FILTERING</th> <td style="vertical-align:top"> Performs <em>basic</em> filtering and returns "de-DE" and "de-DE-1996". </td> <td style="vertical-align:top"> Performs <em>extended</em> filtering and returns "de-DE", "de-Deva-DE", "de-DE-1996", "de-Latn-DE", and "de-Latn-DE-1996". </td> </tr> <tr> <th scope="row" style="vertical-align:top"> FilteringMode#EXTENDED_FILTERING EXTENDED_FILTERING</th> <td style="vertical-align:top"> Performs <em>extended</em> filtering and returns "de-DE", "de-Deva-DE", "de-DE-1996", "de-Latn-DE", and "de-Latn-DE-1996". </td> <td style="vertical-align:top">Same as above.</td> </tr> <tr> <th scope="row" style="vertical-align:top"> FilteringMode#IGNORE_EXTENDED_RANGES IGNORE_EXTENDED_RANGES</th> <td style="vertical-align:top"> Performs <em>basic</em> filtering and returns "de-DE" and "de-DE-1996". </td> <td style="vertical-align:top"> Performs <em>basic</em> filtering and returns null because nothing matches. </td> </tr> <tr> <th scope="row" style="vertical-align:top"> FilteringMode#MAP_EXTENDED_RANGES MAP_EXTENDED_RANGES</th> <td style="vertical-align:top">Same as above.</td> <td style="vertical-align:top"> Performs <em>basic</em> filtering and returns "de-DE" and "de-DE-1996" because "de-*-DE" is mapped to "de-DE". </td> </tr> <tr> <th scope="row" style="vertical-align:top"> FilteringMode#REJECT_EXTENDED_RANGES REJECT_EXTENDED_RANGES</th> <td style="vertical-align:top">Same as above.</td> <td style="vertical-align:top"> Throws IllegalArgumentException because "de-*-DE" is not a valid basic language range. </td> </tr> </tbody> </table>

Added in 1.8.

Java documentation for java.util.Locale.FilteringMode.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Properties

AutoselectFiltering
Class

Returns the runtime class of this Object.

(Inherited from Object)
DeclaringClass

Returns the Class object corresponding to this enum constant's enum type.

(Inherited from Enum)
ExtendedFiltering
Handle

The handle to the underlying Android instance.

(Inherited from Object)
IgnoreExtendedRanges
JniIdentityHashCode (Inherited from Object)
JniPeerMembers
MapExtendedRanges
PeerReference (Inherited from Object)
RejectExtendedRanges
ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

(Inherited from Enum)
ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

(Inherited from Enum)

Methods

Clone()

Throws CloneNotSupportedException.

(Inherited from Enum)
CompareTo(Object)

Compares this enum with the specified object for order.

(Inherited from Enum)
Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
Equals(Object)

Returns true if the specified object is equal to this enum constant.

(Inherited from Enum)
GetHashCode()

Returns a hash code for this enum constant.

(Inherited from Enum)
JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Name()

Returns the name of this enum constant, exactly as declared in its enum declaration.

(Inherited from Enum)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
Ordinal()

Returns the ordinal of this enumeration constant (its position in its enum declaration, where the initial constant is assigned an ordinal of zero).

(Inherited from Enum)
SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
UnregisterFromRuntime() (Inherited from Object)
ValueOf(String)
Values()
Wait()

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to