localeconv(3C) localeconv(3C)
NAME
localeconv() - query the numeric formatting conventions of the current locale
SYNOPSIS
DESCRIPTION
The function sets the components of an object of type (defined in with values appropriate for the formatting of numeric quantities (mone-
tary and otherwise) according to the rules of the program's current locale (see setlocale(3C)).
The members of the structure with type are strings, any of which (except can point to "" (the empty string) to indicate that the value is
not available in the current locale or is of zero length. The members with type are non-negative numbers, any of which can be (defined in
to indicate that the value is not available in the current locale. The members include the following:
The decimal point character used to format nonmonetary quantities.
This is the same value as that returned by a call to with as its argument (see nl_langinfo(3C)).
The character used to separate groups of digits
to the left of the decimal point character in formatted nonmonetary quantities. This is the same value as that returned
by a call to with as its argument (see nl_langinfo(3C)).
A string where the numeric value of each byte
indicates the size of each group of digits in formatted nonmonetary quantities.
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 The
fourth character (immediately preceding the null character) is the character used to separate the international currency
symbol from the monetary quantity.
The local currency symbol applicable to the current locale.
This value along with positioning information is returned by a call to with as its argument (see nl_langinfo(3C)).
The decimal point used to format monetary quantities.
The separator for groups of digits to the left of the decimal point
in formatted monetary quantities.
A string where the numeric value of each byte
indicates the size of each group of digits in formatted monetary quantities.
The string used to indicate a positive valued
formatted monetary quantity.
The string used to indicate a negative valued
formatted monetary quantity.
The number of fractional digits
(those to the right of the decimal point) to be displayed in an internationally formatted monetary quantity.
The number of fractional digits
(those to the right of the decimal point) to be displayed in a locally formatted monetary quantity.
Set to 1 or 0 if the
precedes or succeeds the value for a non-negative formatted monetary quantity.
Set to a value indicating the separation of the
the sign string, and the value of a non-negative formatted monetary quantity.
Set to 1 or 0 if the
precedes or succeeds the value for a negative formatted monetary quantity.
Set to a value indicating the separation of the
the sign string, and the value of a negative formatted monetary quantity.
Set to a value indicating the positioning of the
for a non-negative formatted monetary quantity.
Set to a value indicating the positioning of the
for a negative formatted monetary quantity.
The following members are also available to UNIX 2003 conforming applications:
Set to 1 or 0 if the
precedes or succeeds the value for a non-negative internationally formatted monetary quantity.
Set to a value indicating the separation of the
the sign string, and the value of a non-negative internationally formatted monetary quantity.
Set to 1 or 0 if the
precedes or succeeds the value for a negative internationally formatted monetary quantity.
Set to a value indicating the separation of the
the sign string, and the value of a negative internationally formatted monetary quantity.
Set to a value indicating the positioning of the
for a non-negative internationally formatted monetary quantity.
Set to a value indicating the positioning of the
for a negative internationally formatted monetary quantity.
The numeric value of each byte of and is interpreted according to the following:
No further grouping is to be performed.
The previous byte is to be repeatedly used
for the remainder of the digits.
other The value is the number of digits that comprise the current group. The next byte is examined to determine the size of the
next group of digits to the left of the current group.
The values of and are interpreted according to the following:
No space separates the currency symbol and value.
If the currency symbol and sign string are adjacent, a space separates
them from the value; otherwise, a space separates the currency symbol from the value.
If the currency symbol and sign string are adjacent, a space separates
them; otherwise, a space separates the sign string from the value.
For and the fourth character of is used instead of a space for UNIX 2003 conforming applications.
The values of and are interpreted according to the following:
Parentheses surround the quantity and
or
The sign string precedes the quantity and
or
The sign string succeeds the quantity and
or
The sign string immediately precedes the
or
The sign string immediately succeeds the
or
behaves as if no library function calls
EXTERNAL INFLUENCES
Locale
The category influences the and members of the structure referenced by the pointer returned from a call to
The category influences all of the other members of this structure.
International Code Set Support
Single and multibyte character codesets are supported.
RETURN VALUE
returns a pointer to the filled-in
EXAMPLES
The following table illustrates the formatting used in five languages for monetary quantities.
+---------------+-----------------+-----------------+----------------------+
| Country | Positive format | Negative format | International format |
+---------------+-----------------+-----------------+----------------------+
|en_US.iso88591 | $1,234.56 | -$1,234.56 | USD 1,234.56 |
+---------------+-----------------+-----------------+----------------------+
|it_IT.iso88591 | L.1.234 | -L.1.234 | ITL.1.234 |
+---------------+-----------------+-----------------+----------------------+
|nl_NL.iso88591 | F 1.234,56 | F -1.234,56 | NLG 1.234,56 |
+---------------+-----------------+-----------------+----------------------+
|no_NO.iso88591 | kr1.234,56 | kr1.234,56- | NOK 1.234,56 |
+---------------+-----------------+-----------------+----------------------+
|pt_PT.iso88591 | 1,234$56 | -1,234$56 | PTE 1,234$56 |
+---------------+-----------------+-----------------+----------------------+
For these five languages, the respective values for the monetary members of the structure returned by are:
+------------------+----------+-----------+----------+----------+--------+
| | en_US. | it_IT. | nl_NL. | no_NO. | pt_PT. |
| iso88591 | iso88591 | .iso88591 | iso88591 | iso88591 | |
+------------------+----------+-----------+----------+----------+--------+
|int_curr_symbol | USD | ITL. | NLG | NOK | PTE |
+------------------+----------+-----------+----------+----------+--------+
|currency_symbol | $ | L. | F | kr | $ |
+------------------+----------+-----------+----------+----------+--------+
|mon_decimal_point | . | "" | , | , | $ |
+------------------+----------+-----------+----------+----------+--------+
|mon_thousands_sep | , | . | . | . | , |
+------------------+----------+-----------+----------+----------+--------+
|mon_grouping | 3 | 3 | 3 | 3 | 3 |
+------------------+----------+-----------+----------+----------+--------+
|positive_sign | "" | "" | "" | "" | "" |
+------------------+----------+-----------+----------+----------+--------+
|negative_sign | - | - | - | - | - |
+------------------+----------+-----------+----------+----------+--------+
|int_frac_digits | 2 | 0 | 2 | 2 | 2 |
+------------------+----------+-----------+----------+----------+--------+
|frac_digits | 2 | 0 | 2 | 2 | 2 |
+------------------+----------+-----------+----------+----------+--------+
|p_cs_precedes | 1 | 1 | 1 | 1 | 0 |
+------------------+----------+-----------+----------+----------+--------+
|p_sep_by_space | 0 | 0 | 1 | 0 | 0 |
+------------------+----------+-----------+----------+----------+--------+
|n_cs_precedes | 1 | 1 | 1 | 1 | 0 |
+------------------+----------+-----------+----------+----------+--------+
|n_sep_by_space | 0 | 0 | 1 | 0 | 0 |
+------------------+----------+-----------+----------+----------+--------+
|p_sign_posn | 1 | 1 | 1 | 1 | 1 |
+------------------+----------+-----------+----------+----------+--------+
|n_sign_posn | 4 | 1 | 4 | 2 | 1 |
+------------------+----------+-----------+----------+----------+--------+
WARNINGS
The structure returned by should not be modified by the calling program. Calls to with categories or can overwrite the contents of the
structure that points to when it returns (see setlocale(3C)).
AUTHOR
was developed by OSF and HP.
SEE ALSO
nl_langinfo(3C), setlocale(3C), localedef(4), langinfo(5), thread_safety(5).
STANDARDS CONFORMANCE
localeconv(3C)