Go to the first, previous, next, last section, table of contents.
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.