localeconv

Obtiene información detallada sobre la configuración regional.

Sintaxis

struct lconv *localeconv( void );

Valor devuelto

localeconv devuelve un puntero a un objeto rellenado de tipo struct lconv. Los valores contenidos en el objeto se copian de la configuración regional en el almacenamiento local del subproceso y se pueden sobrescribir mediante llamadas posteriores a localeconv. Los cambios realizados en los valores de este objeto no modifican la configuración regional. Llama a con setlocalecategory valores de LC_ALL, LC_MONETARYo LC_NUMERIC sobrescribe el contenido de la estructura.

Comentarios

La función localeconv obtiene información detallada sobre el formato numérico de la configuración regional actual. Esta información se almacena en una estructura de tipo lconv. Estructura lconv definida en LOCALE. H, contiene los siguientes miembros:

Campo	Significado
decimal_point, _W_decimal_point	Puntero al carácter de coma decimal para cantidades no monetarias.
thousands_sep, _W_thousands_sep	Puntero al carácter que separa grupos de dígitos a la izquierda del separador decimal para cantidades no monetarias.
grouping	Puntero a un entero de tamaño char que contiene el tamaño de cada grupo de dígitos en cantidades no monetarias.
int_curr_symbol, _W_int_curr_symbol	Puntero al símbolo de moneda internacional para la configuración regional actual. Los tres primeros caracteres especifican el símbolo de moneda internacional alfabético como se define en el estándar Códigos ISO 4217 para la representación de las monedas y tipos de fondos. El cuarto carácter (inmediatamente antes del carácter nulo) separa el símbolo de moneda internacional de la cantidad de moneda.
currency_symbol, _W_currency_symbol	Puntero al símbolo de moneda local de la configuración regional actual.
mon_decimal_point, _W_mon_decimal_point	Puntero al carácter de coma decimal para cantidades monetarias.
mon_thousands_sep, _W_mon_thousands_sep	Puntero al separador de grupos de dígitos a la izquierda de la posición decimal en cantidades monetarias.
mon_grouping	Puntero a un entero de tamaño char que contiene el tamaño de cada grupo de dígitos en cantidades monetarias.
positive_sign, _W_positive_sign	Cadena que denota el signo de las cantidades de moneda no negativas.
negative_sign, _W_negative_sign	Cadena que denota el signo de las cantidades de moneda negativas.
int_frac_digits	Número de dígitos a la derecha del separador decimal en las cantidades de moneda con formato internacional.
frac_digits	Número de dígitos a la derecha del separador decimal en las cantidades de moneda con formato.
p_cs_precedes	Se establece en 1 si el símbolo de moneda precede al valor de cantidad de moneda no negativo con formato. Se establece en 0 si el símbolo sigue al valor.
p_sep_by_space	Se establece en 1 si el símbolo de moneda está separado por un espacio del valor de la cantidad de moneda no negativa con formato. Establézcalo en 0 si no hay ninguna separación de espacio.
n_cs_precedes	Se establece en 1 si el símbolo de moneda precede al valor de cantidad de moneda negativo con formato. Se establece en 0 si el símbolo aparece a continuación del valor.
n_sep_by_space	Se establece en 1 si el símbolo de moneda está separado por un espacio del valor de la cantidad de moneda negativa con formato. Establézcalo en 0 si no hay ninguna separación de espacio.
p_sign_posn	En cantidades monetarias con formato no negativo, posición del signo positivo.
n_sign_posn	En cantidades monetarias con formato negativo, posición del signo positivo.

Excepto como se especifica, los miembros de la lconv estructura que tienen char * y wchar_t * versiones son punteros a cadenas. Cualquier miembro que sea igual "" a (o L"" para wchar_t *) es de longitud cero o no se admite en la configuración regional actual. Tanto decimal_point como _W_decimal_point siempre se admiten y tienen una longitud distinta de cero.

Los char miembros de la estructura son números pequeños no negativos, no caracteres. Cualquier miembro que sea igual CHAR_MAX no se admite en la configuración regional actual.

Los valores de grouping y mon_grouping se interpretan según las reglas siguientes:

• CHAR_MAX - No realice ninguna agrupación adicional.

• 0: use el elemento anterior para cada uno de los dígitos restantes.

• n - Número de dígitos que componen el grupo actual. Se examina el siguiente elemento para determinar el tamaño del siguiente grupo de dígitos antes del grupo actual.

Los valores de int_curr_symbol se interpretan según las reglas siguientes:

• Los tres primeros caracteres especifican el símbolo de moneda internacional alfabético como se define en el estándar Códigos ISO 4217 para la representación de las monedas y tipos de fondos.

• El cuarto carácter (inmediatamente antes del carácter nulo) separa el símbolo de moneda internacional de la cantidad de moneda.

Los valores de p_cs_precedes y n_cs_precedes se interpretan según las reglas siguientes (la n_cs_precedes regla está entre paréntesis):

• 0: el símbolo de moneda sigue al valor del valor de moneda con formato no negativo (negativo).

• 1: el símbolo de moneda precede al valor del valor de moneda con formato no negativo (negativo).

Los valores de p_sep_by_space y n_sep_by_space se interpretan según las reglas siguientes (la n_sep_by_space regla está entre paréntesis):

• 0: el símbolo de moneda está separado del valor por un espacio para el valor de moneda con formato no negativo (negativo).

• 1 - No hay ninguna separación de espacio entre el símbolo de moneda y el valor para el valor monetario con formato no negativo.

Los valores de p_sign_posn y n_sign_posn se interpretan según las reglas siguientes:

• 0: los paréntesis rodean la cantidad y el símbolo de moneda.

• 1: la cadena de signo precede a la cantidad y al símbolo de moneda.

• 2: la cadena de signo va después de la cantidad y del símbolo de moneda.

• 3: la cadena de signo precede inmediatamente al símbolo de moneda.

• 4: la cadena de signo va inmediatamente después del símbolo de moneda.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Routine	Encabezado necesario
localeconv	<locale.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Bibliotecas

Todas las versiones de las bibliotecas en tiempo de ejecución de C.

Consulte también

Configuración regional
setlocale
Funciones strcoll
strftime, wcsftime, _strftime_l, _wcsftime_l
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l