localeconv(3C)localeconv(3C)NAMElocaleconv() - query the numeric formatting conventions of the current
locale
SYNOPSISDESCRIPTION
The function sets the components of an object of type (defined in with
values appropriate for the formatting of numeric quantities (monetary
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 mem‐
bers 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 quanti‐
ties.
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 format‐
ted 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 format‐
ted 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 preced‐
ing the null character) is the character used to sepa‐
rate the international currency symbol from the mone‐
tary 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 format‐
ted 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 dis‐
played in an internationally formatted monetary quan‐
tity.
The number of fractional digits
(those to the right of the decimal point) to be dis‐
played in a locally formatted monetary quantity.
Set to 1 or 0 if the
precedes or succeeds the value for a non-negative for‐
matted monetary quantity.
Set to a value indicating the separation of the
the sign string, and the value of a non-negative for‐
matted monetary quantity.
Set to 1 or 0 if the
precedes or succeeds the value for a negative format‐
ted 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 appli‐
cations:
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 interna‐
tionally formatted monetary quantity.
Set to a value indicating the separation of the
the sign string, and the value of a negative interna‐
tionally 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 mem‐
bers 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 pro‐
gram. 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 ALSOnl_langinfo(3C), setlocale(3C), localedef(4), langinfo(5),
thread_safety(5).
STANDARDS CONFORMANCElocaleconv(3C)