localeconv(3P) INTERACTIVE UNIX System (POSIX) localeconv(3P)
NAME
localeconv - numeric formatting convention inquiry
SYNOPSIS
#include <locale.h>
struct lconv *localeconv(void);
DESCRIPTION
The localeconv function sets the components of an object
with type struct lconv with values appropriate for the for-
matting of numeric quantities (monetary and otherwise)
according to the rules of the current locale.
The members of the structure with type char * are pointers
to strings, any of which (except decimal_point) can point to
"", to indicate that the value is not available in the
current locale or is of zero length. The members with type
char are non-negative numbers, any of which can be CHAR_MAX
to indicate that the value is not available in the current
locale. The members include the following:
char *decimal_point
The decimal-point character used to format non-monetary
quantities.
char *thousands_sep
The character used to separate groups of digits before
the decimal-point character in formatted non-monetary
quantities.
char *grouping
A string whose elements indicate the size of each group
of digits in formatted non-monetary quantities.
char *int_curr_symbol
The international currency symbol applicable to the
current locale. The first three characters contain the
alphabetic international currency symbol in accordance
with those specified in ISO 4217 Codes for the
Representation of Currency and Funds. The fourth char-
acter (immediately preceding the null character) is the
character used to separate the international currency
symbol from the monetary quantity.
char *currency_symbol
The local currency symbol applicable to the current
locale.
char *mon_decimal_point
The decimal-point used to format monetary quantities.
char *mon_thousands_sep
The separator for groups of digits before the decimal-
Rev. 1.1 Page 1
localeconv(3P) INTERACTIVE UNIX System (POSIX) localeconv(3P)
point in formatted monetary quantities.
char *mon_grouping
A string whose elements indicate the size of each group
of digits in formatted monetary quantities.
char *positive_sign
The string used to indicate a nonnegative-valued for-
matted monetary quantity.
char *negative_sign
The string used to indicate a negative-valued formatted
monetary quantity.
char int_frac_digits
The number of fractional digits (those after the
decimal-point) to be displayed in an internationally
formatted monetary quantity.
char frac_digits
The number of fractional digits (those after the
decimal-point) to be displayed in a formatted monetary
quantity.
char p_cs_precedes
Set to 1 or 0 if the currency_symbol respectively pre-
cedes or succeeds the value for a non-negative format-
ted monetary quantity.
char p_sep_by_space
Set to 1 or 0 if the currency_symbol respectively is or
is not separated by a space from the value for a non-
negative formatted monetary quantity.
char n_cs_precedes
Set to 1 or 0 if the currency_symbol respectively pre-
cedes or succeeds the value for a negative formatted
monetary quantity.
char n_sep_by_space
Set to 1 or 0 if the currency_symbol respectively is or
is not separated by a space from the value for a nega-
tive formatted monetary quantity.
char p_sign_posn
Set to a value indicating the positioning of the
positive_sign for a non-negative formatted monetary
quantity.
char n_sign_posn
Set to a value indicating the positioning of the
negative_sign for a negative formatted monetary quan-
tity.
Rev. 1.1 Page 2
localeconv(3P) INTERACTIVE UNIX System (POSIX) localeconv(3P)
The elements of grouping and mon_grouping are interpreted
according to the following:
CHAR_MAX
No further grouping is to be performed.
0 The previous element is to be repeatedly used for the
remainder of the digits.
other
The integer value is the number of digits that comprise
the current group. The next element is examined to
determine the size of the next group of digits before
the current group.
The value of p_sign_posn and n_sign_posn is interpreted
according to the following:
0 Parentheses surround the quantity and currency_symbol.
1 The sign string precedes the quantity and
currency_symbol.
2 The sign string succeeds the quantity and
currency_symbol.
3 The sign string immediately precedes the
currency_symbol.
4 The sign string immediately succeeds the
currency_symbol.
RETURN VALUES
The localeconv function returns a pointer to the filled-in
object. The structure pointed to by the return value shall
not be modified by the program, but may be overwritten by a
subsequent call to the localeconv function. In addition,
calls to the setlocale function with categories LC_ALL,
LC_MONETARY, or LC_NUMERIC may overwrite the contents of the
structure.
Rev. 1.1 Page 3