Localidade

A localidade refere-se às configurações de país/região e de idioma que você pode usar para personalizar seu programa. Algumas categorias de localidade dependentes incluem os formatos de exibição para datas e valores monetários. Para obter mais informações, consulte Categorias de localidade.

Use a função de setlocale para alterar ou consultar qualquer ou qualquer programa atual ou para threading informações de localidade quando usar funcionar sem o sufixo de _l . As funções com o sufixo de _l usarão o parâmetro de localidade transmitido para suas informações de localidade durante a execução dessa função específica somente. Para criar uma localidade para uso com uma função com um sufixo de _l , use _create_locale. Para liberar essa localidade, use _free_locale. Para obter a localidade atual, use _get_current_locale.

Use _configthreadlocale para controlar se cada thread tem 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 de funções na tabela a seguir estão disponíveis, indicado pelo sufixo de _s proteger (“”). Para obter mais informações, consulte Recursos de segurança no CRT.

Rotinas de localidade dependente

Rotina	Uso	dependência de configuração da categoria desetlocale
atof, _atof_l, _wtof, _wtof_l	Caractere de conversão ao valor de ponto flutuante	LC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_l	Caractere de conversão para o valor inteiro	LC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_l	Caractere de conversão para o valor inteiro de 64 bits	LC_NUMERIC
atol, _atol_l, _wtol, _wtol_l	Caractere de conversão a ser avaliada por muito tempo	LC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt _atoflt_l	Valor duplo longo de caracteres de conversão	LC_NUMERIC
são rotinas	Inteiro pode testar a condição específica.	LC_CTYPE
isleadbyte, _isleadbyte_l	Teste do byte inicial	LC_CTYPE
localeconv	Valores apropriados de leitura para formatar quantidades numéricas	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	Comprimento máximo em bytes de alguns caracteres multibyte na localidade atual (macro definido em STDLIB.H)	LC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l	Caracteres multibyte de uma cópia	LC_CTYPE
_mbclen, mblen, _mblen_l	Validar e retornar o número de bytes em caracteres multibyte	LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l	Para cadeias de caracteres de multibyte- caractere: validar cada caractere na cadeia de caracteres; retorna o comprimento da cadeia de caracteres	LC_CTYPE
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l	Converter a sequência de caracteres multibyte correspondente à sequência de caracteres amplos	LC_CTYPE
mbtowc, _mbtowc_l	O converter caracteres multibyte ao caractere largo correspondente	LC_CTYPE
funções deprintf	A saída formatada de gravação	LC_NUMERIC (determina saída de caracteres raiz)
funções descanf	Entrada formatado de leitura	LC_NUMERIC (determina o reconhecimento de caracteres raiz)
setlocale, _wsetlocale	Localidade de seleção para o programa	Não aplicável
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l	Compare caracteres de duas cadeias de caracteres	LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l	Compara duas cadeias de caracteres sem considerar o caso	LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l	Compare caracteres de duas cadeias de caracteres (sem diferenciação de maiúsculas e minúsculas)	LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l	Compare primeiros caracteres de n de duas cadeias de caracteres	LC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l	Compare caracteres de duas cadeias de caracteres sem considerar o caso.	LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l	Compare primeiros caracteres de n de duas cadeias de caracteres (sem diferenciação de maiúsculas e minúsculas)	LC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_l	Formatar a data e o valor do tempo de acordo com o argumento fornecido de format	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, em vez, cada letra maiúscula na cadeia de caracteres fornecida a minúsculas	LC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_l	Converter a cadeia de caracteres ao valor de double	LC_NUMERIC (determina o reconhecimento de caracteres raiz)
strtol, wcstol, _strtol_l, _wcstol_l	Converter a cadeia de caracteres ao valorde long	LC_NUMERIC (determina o reconhecimento de caracteres raiz)
strtoul, _strtoul_l, wcstoul, _wcstoul_l	Converter a cadeia de caracteres ao valor longo não assinados	LC_NUMERIC (determina o reconhecimento de caracteres raiz)
_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, em vez, cada letra minúscula na cadeia de caracteres para letras maiúsculas	LC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l	Transformar a cadeia de caracteres no formato ordenado de acordo com a localidade	LC_COLLATE
tolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l	Converter o caractere dado ao caractere minúsculo correspondente	LC_CTYPE
toupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l	Converter o caractere dado à letra maiúscula correspondente	LC_CTYPE
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l	Converter a sequência de caracteres amplos correspondente à sequência de caracteres multibyte	LC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_l	Converter o caractere largo correspondente em caracteres multibyte	LC_CTYPE

Dica

Para rotinas de multibyte, a página de código de multibyte deve equivaler à localidade definida com setlocale._setmbcp, com um argumento de _MB_CP_LOCALE faz a página de código multibyte da mesma forma que a página de código de setlocale .

Consulte também

Referência

Internacionalização

Rotinas de tempo de execução por categoria