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
atof, _atof_l, _wtof, _wtof_l	Converter caractere em valor de ponto flutuante	LC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_l	Converter caractere em valor inteiro	LC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_l	Converter caractere em valor inteiro de 64 bit	LC_NUMERIC
Atol, _atol_l, _wtol, _wtol_l	Converter caractere em valor longo	LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt _atoflt_l	Converter caractere em valor dupla longa	LC_NUMERIC
é rotinas	Teste de dado inteiro para determinada condição.	LC_CTYPE
isleadbyte, _isleadbyte_l	Testar o byte inicial	LC_CTYPE
localeconv	Ler os valores apropriados para a formatação numéricas quantidades	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	Comprimento máximo em bytes de qualquer caractere multibyte na localidade corrente (definida no STDLIB.H macro)	LC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l	Copiar multibyte um caractere	LC_CTYPE
_mbclen mblen, _mblen_l	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
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l	Converter a sequência de caracteres multibyte em correspondente sequência de caracteres largos	LC_CTYPE
mbtowc, _mbtowc_l	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)
setlocale, _wsetlocale	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
STRFTIME, wcsftime, _strftime_l, _wcsftime_l	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
strtod, _strtod_l, wcstod, _wcstod_l	Convert character string to double value	LC_NUMERIC (determina o reconhecimento de caractere fracionário)
strtol, wcstol, _strtol_l, _wcstol_l	Convert character string to longvalue	LC_NUMERIC (determina o reconhecimento de caractere fracionário)
strtoul, _strtoul_l, wcstoul, _wcstoul_l	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
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l	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
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l	Converter sequência de caracteres largos em sequência correspondente de caracteres multibyte	LC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_l	Converter caractere largos em correspondentes de caractere multibyte	LC_CTYPE

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.

Consulte também

Referência

Internacionalização

em time de execução Rotinas por categoria