Nomes de localidade
Um nome de de localidade baseia-se nas convenções de marcação de idioma de do IETF BCP 47 ( Windows Vista e posterior) e é representado por LOCALE_SNAME. Geralmente, o padrão <language>-<REGION>
é usado. Aqui, o idioma é um código de idioma ISO 639 em letras minúsculas. Os códigos do ISO 639-1 são usados quando disponíveis. Caso contrário, códigos do ISO 639-2/T são usados. REGION especifica um identificador de país/região iso 3166-1 maiúsculo. Por exemplo, o nome da localidade para inglês (Estados Unidos) é "en-US" e o nome da localidade de Divehi (Maldivas) é "dv-MV".
Nota
A LOCALE_NAME_MAX_LENGTH constante fornece o comprimento máximo de um nome de localidade. Ele inclui espaço para um caractere nulo de terminação.
Se a localidade for uma localidade neutra (sem região), o valor LOCALE_SNAME seguirá o padrão <language>
. Se for uma localidade neutra para a qual o script é significativo, o padrão será <language>-<Script>
.
Se uma localidade precisar ser distinguida de outra localidade para o mesmo idioma e região usando um script diferente, o valor LOCALE_SNAME seguirá o padrão <language>-<Script>-<REGION>
, em que Script é um código de script ISO 15924 inicial. Por exemplo, o valor LOCALE_SNAME para o uzbeque específico (Latino, Uzbequistão) é "uz-Latn-UZ". O componente de script não é incluído em casos em que um idioma é comumente escrito em apenas um script.
Os pedidos de classificação para localidades são designados usando identificadores de ordem de classificação, por exemplo, SORT_DEFAULT. Para distinguir dois ou mais pedidos de classificação para o mesmo idioma e região, o nome da localidade segue o padrão <language>-<REGION>\_<sort order>
. Se você precisar distinguir o script e a ordem de classificação, o nome seguirá o padrão <language>-<Script>-<REGION>\_<sort order>
. A ordem de classificação padrão nunca é especificada explicitamente, apenas a ordem de classificação alternativa. Por exemplo, húngaro (Hungria) com SORT_DEFAULT ou SORT_HUNGARIAN_DEFAULT numericamente equivalente é designado "hu-HU". Húngaro (Hungria) com ordem de classificação SORT_HUNGARIAN_TECHNICAL é designado "hu-HU_technl".
Para um localidade de substituição, o nome da localidade deve ser o mesmo que o nome da localidade que está sendo substituída. Para uma localidade suplementar, o nome da localidade deve seguir o padrão de <language>-<REGION>-x-<custom>
ou <language>-<Script>-<REGION>-x-<custom>
, em que <custom>
é uma cadeia de caracteres alfanumérica específica para a localidade suplementar. Por exemplo, uma localidade suplementar específica a uma empresa chamada Fabricam pode ser chamada de "en-US-x-fabricam".
Um aplicativo pode recuperar os nomes de localidade atuais usando as funçõesGetSystemDefaultLocaleNamee GetUserDefaultLocaleName. Embora cada thread possa recuperar e definir seu próprio identificador de localidade com GetThreadLocale e defini-lo com SetThreadLocale, não há funções análogas para obter e definir a localidade por nome.