Locale.Builder Class

Definition

[Android.Runtime.Register("java/util/Locale$Builder", DoNotGenerateAcw=true)]
public sealed class Locale.Builder : Java.Lang.Object

[<Android.Runtime.Register("java/util/Locale$Builder", DoNotGenerateAcw=true)>]
type Locale.Builder = class
    inherit Object

Inheritance

Object

Object

Locale.Builder

Attributes

RegisterAttribute

Remarks

Builder is used to build instances of Locale from values configured by the setters. Unlike the Locale constructors, the Builder checks if a value configured by a setter satisfies the syntax requirements defined by the Locale class. A Locale object created by a Builder is well-formed and can be transformed to a well-formed IETF BCP 47 language tag without losing information.

<b>Note:</b> The Locale class does not provide any syntactic restrictions on variant, while BCP 47 requires each variant subtag to be 5 to 8 alphanumerics or a single numeric followed by 3 alphanumerics. The method setVariant throws IllformedLocaleException for a variant that does not satisfy this restriction. If it is necessary to support such a variant, use a Locale constructor. However, keep in mind that a Locale object created this way might lose the variant information when transformed to a BCP 47 language tag.

The following example shows how to create a Locale object with the Builder. <blockquote>

Locale aLocale = new Builder().setLanguage("sr").setScript("Latn").setRegion("RS").build();

</blockquote>

Builders can be reused; clear() resets all fields to their default values.

Added in 1.7.

Java documentation for java.util.Locale.Builder.

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.

Constructors

Properties

Methods

Explicit Interface Implementations

Extension Methods

Applies to