Configuración regional

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Locale hace referencia a los valores de país o región y de idioma que se pueden usar para personalizar un programa. Entre las categorías dependientes de la configuración regional se encuentran los formatos de presentación de fechas y de valores de moneda. Para obtener más información, vea Categorías de configuración regional.

Use la función setlocale para cambiar o consultar parte de la información, o toda ella, de configuración regional del programa o subproceso actual, mientras usa funciona sin el sufijo _l. Las funciones con el sufijo _l usan el parámetro de configuración regional que se pasa para la información de configuración regional solo durante la ejecución de esa función concreta. Para crear una configuración regional y usarla con una función que tenga el sufijo _l, use _create_locale. Para liberar esta configuración regional, use _free_locale. Para obtener la configuración regional actual, use _get_current_locale.

Use _configthreadlocale para determinar si cada subproceso tiene su propia configuración regional o todos los subprocesos de un programa comparten la misma configuración regional. Para obtener más información, vea Configuraciones regionales y páginas de códigos.

Existen versiones más seguras de las funciones de la tabla siguiente, que se indican mediante el sufijo _s (“segura”). Para obtener más información, vea Características de seguridad de CRT.

Rutinas dependientes de la configuración regional

RutinaUtilicedependencia de configuración de categorías setlocale
atof, _atof_l, _wtof, _wtof_lConvierte el carácter en valor de punto flotanteLC_NUMERIC
atoi, _atoi_l, _wtoi, _wtoi_lConvierte el carácter en valor enteroLC_NUMERIC
_atoi64, _atoi64_l, _wtoi64, _wtoi64_lConvierte el carácter en valor entero de 64 bitsLC_NUMERIC
atol, _atol_l, _wtol, _wtol_lConvierte el carácter en valor longLC_NUMERIC
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_lConvierte el carácter en valor double-longLC_NUMERIC
is RoutinesComprueba un entero dado para determinar si cumple una condición concretaLC_CTYPE
isleadbyte, _isleadbyte_lComprueba si se trata de un byte inicialLC_CTYPE
localeconvLee los valores adecuados para dar formato a cantidades numéricasLC_MONETARY, LC_NUMERIC
MB_CUR_MAXLongitud máxima en bytes de cualquier carácter multibyte en la configuración regional actual (macro definida en STDLIB.H)LC_CTYPE
_mbccpy, _mbccpy_l,_mbccpy_s, _mbccpy_s_lCopia un carácter multibyteLC_CTYPE
_mbclen, mblen, _mblen_lValida y devuelve el número de bytes del carácter multibyteLC_CTYPE
strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_lEn el caso de cadenas de caracteres multibyte: valida cada carácter de la cadena; devuelve la longitud de la cadenaLC_CTYPE
mbstowcs, _mbstowcs_l,mbstowcs_s, _mbstowcs_s_lConvierte la secuencia de caracteres multibyte en la secuencia correspondiente de caracteres anchosLC_CTYPE
mbtowc, _mbtowc_lConvierte el carácter multibyte en el carácter ancho correspondienteLC_CTYPE
Funciones printfEscribe resultados con formatoLC_NUMERIC (determina la salida de caracteres de base)
Funciones scanfLee la entrada con formatoLC_NUMERIC (determina el reconocimiento de caracteres de base)
setlocale, _wsetlocaleSelecciona la configuración regional del programaNo es aplicable
strcoll, wcscoll, _mbscoll, _strcoll_l, _wcscoll_l, _mbscoll_lCompara los caracteres de dos cadenasLC_COLLATE
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_lCompara dos cadenas sin distinción entre mayúsculas y minúsculasLC_CTYPE
_stricoll, _wcsicoll, _mbsicoll, _stricoll_l, _wcsicoll_l, _mbsicoll_lCompara los caracteres de dos cadenas sin distinción entre mayúsculas y minúsculasLC_COLLATE
_strncoll, _wcsncoll, _mbsncoll, _strncoll_l, _wcsncoll_l, _mbsncoll_lCompara los primeros n caracteres de dos cadenasLC_COLLATE
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_lCompara los caracteres de dos cadenas sin distinción entre mayúsculas y minúsculasLC_CTYPE
_strnicoll, _wcsnicoll, _mbsnicoll, _strnicoll_l, _wcsnicoll_l, _mbsnicoll_lCompara los primeros n caracteres de dos cadenas sin distinción entre mayúsculas y minúsculasLC_COLLATE
strftime, wcsftime, _strftime_l, _wcsftime_lDa formato al valor de fecha y hora de acuerdo con el argumento format proporcionadoLC_TIME
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_lConvierte, en contexto, cada mayúscula de la cadena especificada en minúsculaLC_CTYPE
strtod, _strtod_l, wcstod, _wcstod_lConvierte el valor de cadena en valor doubleLC_NUMERIC (determina el reconocimiento de caracteres de base)
strtol, wcstol, _strtol_l, _wcstol_lConvierte el valor de cadena en valor longLC_NUMERIC (determina el reconocimiento de caracteres de base)
strtoul, _strtoul_l, wcstoul, _wcstoul_lConvierte la cadena de caracteres en valor long sin signoLC_NUMERIC (determina el reconocimiento de caracteres de base)
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_lConvierte, en contexto, cada minúscula de la cadena especificada en mayúsculaLC_CTYPE
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_lTransforma la cadena en formato intercalado según la configuración regionalLC_COLLATE
tolower, _tolower, towlower, _tolower_l, _towlower_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_lConvierte el carácter dado en el carácter en minúscula correspondienteLC_CTYPE
toupper, _toupper, towupper, _toupper_l, _towupper_l,_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_lConvierte el carácter dado en la letra mayúscula correspondienteLC_CTYPE
wcstombs, _wcstombs_l,wcstombs_s, _wcstombs_s_lConvierte la secuencia de caracteres anchos en la secuencia correspondiente de caracteres multibyteLC_CTYPE
wctomb, _wctomb_l,wctomb_s, _wctomb_s_lConvierte el carácter ancho en el carácter multibyte correspondienteLC_CTYPE
System_CAPS_ICON_note.jpg Nota

En el caso de las rutinas multibyte, la página de códigos multibyte debe ser equivalente a la configuración regional establecida mediante setlocale. _setmbcp, con el argumento _MB_CP_LOCALE, hace que la página de códigos multibyte sea igual que la página de códigos de setlocale.

Internacionalización
Rutinas de tiempo de ejecución por categoría

Mostrar: