Table of Contents
Previous Section Next Section

localeconv

#include <locale.h>struct lconv *localeconv(void);

The localeconv( ) function returns a pointer to a structure of type lconv, which contains various geopolitical environmental information relating to the way numbers are formatted. The lconv structure contains the following members:

char *decimal_point;     /* Decimal point character
                            for nonmonetary values. */
char *thousands_sep;     /* Thousands separator
                            for nonmonetary values. */
char *grouping;          /* Specifies grouping for
                            nonmonetary values. */
char *int_curr_symbol;   /* International currency symbol. */
char *currency_symbol;   /* Local currency symbol. */
char *mon_decimal_point; /* Decimal point character for
                            monetary values. */
char *mon_thousands_sep; /* Thousands separator for
                            values. */
char *mon_grouping;      /* Specifies grouping for
                            monetary values. */
char *positive_sign;     /* Positive value indicator for
                            monetary values. */
char *negative_sign;     /* Negative value indicator for
                            monetary values. */
char int_frac_digits;    /* Number of digits displayed to the
                            right of the decimal point for
                            monetary values displayed using
                            international format. */
char frac_digits;        /* Number of digits displayed to the
                            right of the decimal point for
                            monetary values displayed using
                            local format. */
char p_cs_precedes;      /* 1 if currency symbol precedes
                            positive value, 0 if currency
                            symbol follows value. */
char p_sep_by_space;     /* 1 if currency symbol is
                            separated from value by a space, 
                            0 otherwise. In C99, contains a
                            value that indicates separation. */
char n_cs_precedes;      /* 1 if currency symbol precedes
                            a negative value, 0 if currency
                            symbol follows value. */
char n_sep_by_space;     /* 1 if currency symbol is
                            separated from a negative
                            value by a space, 0 if
                            currency symbol follows value.
                            In C99, contains a value that
                            indicates separation. */
char p_sign_posn;        /* Indicates position of
                            positive value symbol. */
char n_sign_posn;        /* Indicates position of
                            negative value symbol. */

/* The following members were added by C99. */
char _p_cs_precedes;     /* 1 if currency symbol precedes
                            positive value, 0 if currency
                            symbol follows value. Applies to 
                            internationally formatted values. */
char _p_sep_by_space;    /* Indicates the separation between the
                            currency symbol, sign, and a positive value.
                            Applies to internationally formatted values. */
char _n_cs_precedes;     /* 1 if currency symbol precedes
                            a negative value, 0 if currency
                            symbol follows value. Applies to 
                            internationally formatted values. */
char _n_sep_by_space;    /* Indicates the separation between the
                            currency symbol, sign, and a negative value.
                            Applies to internationally formatted values. */
char _p_sign_posn;       /* Indicates position of
                            positive value symbol. Applies to 
                            internationally formatted values.  */
char _n_sign_posn;       /* Indicates position of
                            negative value symbol. Applies to 
                            internationally formatted values.  */

The localeconv( ) function returns a pointer to the lconv structure. You must not alter the contents of this structure. Refer to your compiler's documentation for implementation-specific information relating to the lconv structure.

A related function is setlocale( ).


Table of Contents
Previous Section Next Section