Localidade
"Localidade" refere-se a localidade (o Country/região e linguagem) para o qual você pode personalizar determinados aspectos do seu programa.Algumas categorias dependente de localidade incluem a formatação de datas e o formato de exibição de valores monetários.Para obter mais informações, consulte Categorias de localidade.
Use o setlocale função para alterar ou consultar algumas ou todas as corrente do programa ou thread informações de localidade ao utilizar funções sem o _l sufixo. As funções com o _l sufixo irá usar o parâmetro de localidade passado para suas informações de localidade durante a execução somente dessa função específica. Para criar uma localidade para uso com uma função com um _l sufixo, uso _create_locale. Para liberar essa localidade, use _free_locale. Para obter a localidade corrente, use _get_current_locale.
Use _configthreadlocale para controlar se a cada segmento possui sua própria localidade ou todos os threads em um programa compartilham a mesma localidade.Para obter mais informações, consulte Localidades e páginas de código.
Versões mais seguras as funções na tabela a seguir estão disponível, indicado pelo _ssufixo ("seguro"). For more information, see Aprimoramentos de segurança no CRT.
Rotinas de dependente de localidade
Rotina |
Uso |
setlocale dependência de definição de categoria |
|---|---|---|
Converter caractere em valor de ponto flutuante |
LC_NUMERIC |
|
Converter caractere em valor inteiro |
LC_NUMERIC |
|
Converter caractere em valor inteiro de 64 bit |
LC_NUMERIC |
|
Converter caractere em valor longo |
LC_NUMERIC |
|
Converter caractere em valor dupla longa |
LC_NUMERIC |
|
Teste de dado inteiro para determinada condição. |
LC_CTYPE |
|
Testar o byte inicial |
LC_CTYPE |
|
Ler os valores apropriados para a formatação numéricas quantidades |
LC_MONETARY, LC_NUMERIC |
|
Comprimento máximo em bytes de qualquer caractere multibyte na localidade corrente (definida no STDLIB.H macro) |
LC_CTYPE |
|
Copiar multibyte um caractere |
LC_CTYPE |
|
Validar e retornar o número de bytes em caractere multibyte |
LC_CTYPE |
|
strlen, strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l |
Para seqüências de caractere multibyte: validar cada caractere na seqüência de caracteres; retorna o comprimento da seqüência de caracteres |
LC_CTYPE |
Converter a sequência de caracteres multibyte em correspondente sequência de caracteres largos |
LC_CTYPE |
|
Converter caracteres multibyte correspondente caractere largo |
LC_CTYPE |
|
printf funções |
Gravar saída formatada |
LC_NUMERIC (determina a saída de caractere fracionário) |
scanf funções |
Leitura formatado de entrada |
LC_NUMERIC (determina o reconhecimento de caractere fracionário) |
selecionar a localidade do programa |
Não aplicável. |
|
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l |
comparar os caracteres de duas seqüências de caracteres |
LC_COLLATE |
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l |
Comparar duas seqüências de caracteres sem considerar a caso |
LC_CTYPE |
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l |
comparar caracteres de duas seqüências de caracteres (caso Kana) |
LC_COLLATE |
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l |
comparar primeiro n caracteres de duas seqüências de caracteres |
LC_COLLATE |
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l |
comparar os caracteres de duas seqüências de caracteres sem considerar a caso. |
LC_CTYPE |
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l |
comparar primeiro n caracteres de duas seqüências de caracteres (sem distinção entre maiúsculas e minúsculas) |
LC_COLLATE |
Formato de data e time em valor de acordo com fornecido format argumento |
LC_TIME |
|
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l |
Converter, no lugar, cada maiúsculas carta em determinada cadeia de caracteres para em minúsculas |
LC_CTYPE |
Convert character string to double value |
LC_NUMERIC (determina o reconhecimento de caractere fracionário) |
|
Convert character string to longvalue |
LC_NUMERIC (determina o reconhecimento de caractere fracionário) |
|
Converter seqüência de caractere em valor longo não assinado |
LC_NUMERIC (determina o reconhecimento de caractere fracionário) |
|
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l |
Converter, no lugar, cada letra em minúsculas na seqüência de caracteres em maiúsculas |
LC_CTYPE |
Transformar seqüência de caracteres em formulário agrupado de acordo com local |
LC_COLLATE |
|
ToLower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l |
Converter determinado caractere a caractere correspondente em minúsculas |
LC_CTYPE |
ToUpper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l |
Converter determinado caractere para letra maiúscula correspondente |
LC_CTYPE |
Converter sequência de caracteres largos em sequência correspondente de caracteres multibyte |
LC_CTYPE |
|
Converter caractere largos em correspondentes de caractere multibyte |
LC_CTYPE |
.gif "Observação") Observação: |
|---|
Para rotinas de vários bytes, a página de código multibyte deve ser equivalente a localidade com setlocale._setmbcp, com um argumento de _MB_CP_LOCALE torna o código multibyte a mesma página sistema autônomo o setlocale página de código. |