Locale.ToLanguageTag Método

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

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

Retornos

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 atenda aos requisitos de sintaxe da marca de idioma BCP 47 do IETF, esse método manipulará esses campos, conforme descrito abaixo:

<b>Idioma:</b> Se o idioma estiver vazio ou não for bem formado (por exemplo, "a" ou "e2"), ele será emitido como "und" (indeterminado).

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

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

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

<li>se qualquer sub segmentação não corresponder [0-9a-zA-Z]{1,8}, a variante será truncada e o sub-segmento problemático e todos os sub-segmentos a seguir 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 seja bem formado). Por exemplo, "Solaris_isjustthecoolestthing" é emitido como "x-lvariant-Solaris", não como "solaris".</li></ul>

<b>Conversões Especiais:</b> Java dá suporte a 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 "ele", "yi" e "id", respectivamente.

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

<b>Observação:</b> Embora a marca de idioma criada por esse método seja bem formada (atende aos 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 Registro de Subtag de Idioma IANA.

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 Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.