Go to the first, previous, next, last section, table of contents.


localeconv

Syntax

#include <locale.h>

struct lconv *localeconv(void);

Description

This function returns a pointer to a static structure that contains information about the current locale. The structure contains these fields:

char *currency_symbol
A string that should be used when printing local currency.
char *decimal_point
A string that is used to separate the integer and fractional portions of real numbers in printf. Currently, only the first character is significant.
char *grouping
An array of numbers indicating the size of groupings for non-monetary values to the left of the decimal point. The first number is the size of the grouping just before the decimal point. A number of zero means to repeat the previous number indefinitely. A number of CHAR_MAX means to group the remainder of the digits together.
char *int_curr_symbol
A string that should be used when formatting monetary values for local currency when the result will be used internationally.
char *mon_decimal_point
A string that separates the interger and fractional parts of monetary values.
char *mon_grouping
Same as grouping, but for monetary values.
char *negative_sign
A string that is used to represent negative monetary values.
char *positive_sign
A string that is used to represent positive monetary values.
char *thousands_sep
The grouping separator for non-monetary values.
char frac_digits
The number of digits to the right of the decimal point for monetary values.
char int_frac_digits
Like frac_digits, but when formatting for international use.
char n_cs_precedes
If nonzero, the currency string should precede the monetary value if the monetary value is negative.
char n_sep_by_space
If nonzero, the currency string and the monetary value should be separated by a space if the monetary value is negative.
char n_sign_posn
Determines the placement of the negative indication string if the monetary value is negative.
0
($value), (value$)
1
-$value, -value$
2
$value-, value$-
3
-$value, value-$
4
$-value, value$-
char p_cs_precedes
char p_sep_by_space
char p_sign_posn
These are the same as n_*, but for when the monetary value is positive.

Note that any numeric field may have a value of CHAR_MAX, which indicates that no information is available.

Return Value

A pointer to the struct lconv structure.

Portability

ANSI, POSIX

Example

struct lconv *l = localeconv;
printf("%s%d\n", l->negative_sign, value);


Go to the first, previous, next, last section, table of contents.