Locale.ToLanguageTag Método

Definição

Namespace:

Java.Util

Assembly:

Mono.Android.dll

Retorna uma marca de idioma IETF BCP 47 bem formada que representa essa localidade.

[Android.Runtime.Register("toLanguageTag", "()Ljava/lang/String;", "")]
public string ToLanguageTag ();

[<Android.Runtime.Register("toLanguageTag", "()Ljava/lang/String;", "")>]
member this.ToLanguageTag : unit -> string

Retornos

String

uma marca de idioma BCP47 que representa a localidade

Atributos

RegisterAttribute

Comentários

Retorna uma marca de idioma IETF BCP 47 bem formada que representa essa localidade.

Se isso Locale tiver um idioma, país ou variante que não satisfaça os requisitos de sintaxe de marca de idioma IETF BCP 47, esse método manipulará esses campos conforme descrito abaixo:

<b>Idioma:</b> Se a linguagem estiver vazia, ou não estiver bem formada (por exemplo, "a" ou "e2"), ela será emitida como "und" (Indeterminada).

<b>País:</b> Se o país não estiver bem formado (por exemplo, "12" ou "EUA"), ele será omitido.

<b>Variante:</b> Se a variante <b>for</b> bem formada, cada subsegmento (delimitado por '-' ou '_') é emitido como uma subtag. Caso contrário: <ul>

<li>se todos os subsegmentos corresponderem [0-9a-zA-Z]{1,8} (por exemplo, "WIN" ou "Oracle_JDK_Standard_Edition"), o primeiro subsegmento mal formado e todos os seguintes serão anexados à subtag de uso privado. A primeira subtag anexada será "lvariante", seguida pelos subsegmentos em ordem, separados por hífen. Por exemplo, "x-lvariant-WIN", "Oracle-x-lvariant-JDK-Standard-Edition".

<li>se qualquer sub-segmento não corresponder [0-9a-zA-Z]{1,8}, a variante será truncada e o sub-segmento problemático e todos os sub-segmentos seguintes serão omitidos. Se o restante não estiver vazio, ele será emitido como uma subtag de uso privado como acima (mesmo que o restante se mostre bem formado). Por exemplo, "Solaris_isjustthecoolestthing" é emitido como "x-lvariant-Solaris", não como "solaris".</li></ul>

<b>Conversões Especiais:</b> Java suporta algumas representações de localidade antigas, incluindo códigos de linguagem ISO preteridos, para compatibilidade. Esse método executa as seguintes conversões: <ul>

<li>Os códigos de linguagem ISO preteridos "iw", "ji" e "in" são convertidos em "he", "yi" e "id", respectivamente.

<li>Uma localidade com o idioma "não", o país "NÃO" e a variante "NY", representando o norueguês Nynorsk (Noruega), é convertida em uma marca de idioma "nn-NO".</li></ul>

<b>Nota:</b> Embora a marca de idioma criada por esse método seja bem formada (satisfaça os requisitos de sintaxe definidos pela especificação IETF BCP 47), ela não é necessariamente uma marca de idioma BCP 47 válida. Por exemplo,

new Locale("xx", "YY").toLanguageTag();

retornará "xx-YY", mas a subtag de idioma "xx" e a subtag de região "YY" são inválidas porque não estão registradas no IANA Language Subtag Registry.

Adicionado em 1.7.

Documentação Java para java.util.Locale.toLanguageTag().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.