Partilhar via

Localidade

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

Use a setlocale função para alterar ou consultar algumas ou todas as informações de localidade do programa ou thread atual enquanto usa funções sem o sufixo _l . As funções com o sufixo _l usarão o parâmetro locale passado para suas informações de localidade durante a execução dessa função específica apenas. Para criar uma localidade para uso com uma função com um sufixo _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 se todos os threads em um programa compartilham a mesma localidade. Para obter mais informações, consulte Localidades e páginas de código.

Estão disponíveis versões mais seguras das funções na tabela seguinte, indicadas pelo sufixo _s ("secure"). Para obter mais informações, consulte Recursos de segurança na CRT.

Rotinas dependentes da localidade

Rotina Utilização 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 bits 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 duplo-longo LC_NUMERIC
is, isw rotinas Teste dado inteiro para uma condição particular. LC_CTYPE
isleadbyte, _isleadbyte_l Teste para byte de chumbo LC_CTYPE
localeconv Leia os valores apropriados para formatar quantidades numéricas LC_MONETARY, LC_NUMERIC
MB_CUR_MAX Comprimento máximo em bytes de qualquer caractere multibyte na localidade atual (macro definida em STDLIB.H) LC_CTYPE
_mbccpy, _mbccpy_l, _mbccpy_s, _mbccpy_s_l Copiar um caractere multibyte LC_CTYPE
_mbclen, mblen, _mblen_l Validar e retornar o número de bytes em caractere multibyte LC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l Para cadeias de caracteres de vários bytes: valide cada caractere em string; comprimento da cadeia de caracteres de retorno LC_CTYPE
mbstowcs, _mbstowcs_l, mbstowcs_s, _mbstowcs_s_l Converter sequência de caracteres multibyte em sequência correspondente de caracteres largos LC_CTYPE
mbtowc, _mbtowc_l Converter caractere multibyte em caractere largo correspondente LC_CTYPE
printf funções Escrever saída formatada LC_NUMERIC (determina a saída de caracteres radix)
scanf funções Ler entrada formatada LC_NUMERIC (determina o reconhecimento de caracteres radix)
setlocale, _wsetlocale Selecionar localidade para o programa Não aplicável
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_l Comparar caracteres de duas cadeias de caracteres LC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l Comparar duas cadeias de caracteres sem considerar maiúsculas e minúsculas LC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l Comparar caracteres de duas cadeias de caracteres (sem distinção entre maiúsculas e minúsculas) LC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_l Comparar os primeiros n caracteres 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 maiúsculas e minúsculas. LC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_l Comparar os primeiros n caracteres de duas cadeias de caracteres (não diferencia maiúsculas de minúsculas) LC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_l Formatar o valor de data e hora de acordo com o argumento fornecido 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 Converta, no lugar, cada letra maiúscula em determinada cadeia de caracteres em minúsculas LC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_l Converter cadeia de caracteres em double valor LC_NUMERIC (determina o reconhecimento de caracteres radix)
strtol, wcstol, _strtol_l, _wcstol_l Converter cadeia de caracteres em long valor LC_NUMERIC (determina o reconhecimento de caracteres radix)
strtoul, _strtoul_l, wcstoul, _wcstoul_l Converter cadeia de caracteres em valor longo não assinado LC_NUMERIC (determina o reconhecimento de caracteres radix)
_strupr, _strupr_l, , _mbsupr_mbsupr_l, _wcsupr_l, _wcsupr_strupr_s_strupr_s_l_mbsupr_s_mbsupr_s_l_wcsupr_s_wcsupr_s_l Converta, no lugar, cada letra minúscula em cadeia de caracteres em maiúsculas LC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l Transformar cadeia de caracteres em forma agrupada de acordo com a localidade LC_COLLATE
tolower, _tolower, towlower, , _tolower_l, _towlower_l_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l Converter determinado caractere em minúsculas correspondente LC_CTYPE
toupper, _toupper, towupper, , _toupper_l, _towupper_l_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l Converter determinado caractere em 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 largo em caractere multibyte correspondente LC_CTYPE

Observação

Para rotinas multibyte, a página de código multibyte deve ser equivalente à localidade definida com setlocale. _setmbcp, com um argumento de torna a página de código multibyte igual à _MB_CP_LOCALE página de setlocale código.

Ver também

Internacionalização
Rotinas de tempo de execução Universal C por categoria

  • Last updated on