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 setlocale category 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