Localidade

A localidade refere-se as configurações de país/região e da linguagem que você pode usar para personalizar seu programa.Algumas categorias de são 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 modificar ou consulte qualquer ou qualquer programa atual ou para threads informações de localidade quando usar para funcionar sem o sufixo de _l .As funções com o sufixo de _l usarão o parâmetro de localidade passado 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 esta localidade, use _free_locale.Para obter a localidade atual, use _get_current_locale.

Use _configthreadlocale para controlar se cada segmento tem sua própria localidade, ou todos os segmentos em um programa compartilham a mesma localidade.Para obter mais informações, consulte Localidades e páginas de código.

Versões mais seguros 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 são dependentes

Rotina

Uso

dependência da categoria desetlocale

atof, _atof_l, _wtof, _wtof_l

Caractere de converter o valor de ponto flutuante

LC_NUMERIC

atoi, _atoi_l, _wtoi, _wtoi_l

Caractere de converter o valor inteiro

LC_NUMERIC

_atoi64, _atoi64_l, _wtoi64, _wtoi64_l

Caractere de converter o valor inteiro de 64 bits

LC_NUMERIC

Atol, _atol_l, _wtol, _wtol_l

Caractere de converter para avaliar long

LC_NUMERIC

_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt _atoflt_l

Valor do caractere de converter

LC_NUMERIC

são rotinas

Número inteiro dado testar a condição específica.

LC_CTYPE

isleadbyte, _isleadbyte_l

Teste para o 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 qualquer caractere de multibyte na localidade atual (macro definido em STDLIB.H)

LC_CTYPE

_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_l

Caractere de multibyte de impressão uma

LC_CTYPE

_mbclen, mblen, _mblen_l

Validação e retornar o número de bytes no caractere de multibyte

LC_CTYPE

strlen strlen_l, wcslen, wcslen_l, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l

Para cadeias de caracteres de multibyte- caractere: validar cada caractere na cadeia de caracteres; retornao comprimento da cadeia de caracteres

LC_CTYPE

mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_l

Converter a sequência de caracteres de multibyte correspondente à sequência de caracteres largos

LC_CTYPE

mbtowc, _mbtowc_l

Converter o caractere de multibyte grande para o caractere correspondente

LC_CTYPE

funções deprintf

Formatados saída de gravação

LC_NUMERIC (determina saída de caracteres raiz)

funções descanf

Entrada formatado de leitura

LC_NUMERIC (determina o reconhecimento de caractere raiz)

setlocale, wsetlocale

Selecione localidade 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

Compare duas cadeias de caracteres sem considerar aos casos

LC_CTYPE

_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_l

Compare duas cadeias de caracteres 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 duas cadeias de caracteres de caracteres sem considerar ao 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 o valor de data e 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, no lugar, cada letra maiúscula na cadeia de caracteres fornecida em 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 caractere raiz)

strtol, wcstol, _strtol_l, _wcstol_l

Converter a cadeia de caracteres ao valorde long

LC_NUMERIC (determina o reconhecimento de caractere raiz)

strtoul, _strtoul_l, wcstoul, _wcstoul_l

Converter a cadeia de caracteres para o valor unsigned long

LC_NUMERIC (determina o reconhecimento de caractere 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, no lugar, cada letra minúscula na cadeia de caracteres para maiúscula

LC_CTYPE

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l

Transformando a cadeia de caracteres no formulário 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 determinado a letra maiúscula correspondente

LC_CTYPE

wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_l

Converter a sequência de caracteres da sequência de caracteres de multibyte correspondente

LC_CTYPE

wctomb, _wctomb_l,wctomb_s, _wctomb_s_l

Converter o caractere grande para o caractere correspondente de multibyte

LC_CTYPE

ObservaçãoObservação

Para rotinas de multibyte, a página de código de multibyte deve ser equivalente à localidade com setlocale._setmbcp, com um argumento de _MB_CP_LOCALE faz à página de código de multibyte o mesmo que a página de código de setlocale .

Consulte também

Referência

Internacionalização

Rotinas de tempo de execução por categoria