localeconv - Retrieve locale-dependent formatting parameters
#include <locale.h>
struct lconv *localeconv(
void );
Standard C Library (libc)
Interfaces documented on this reference page conform to
industry standards as follows:
localeconv(): XSH5.0
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
The localeconv() function provides access to the object
that specifies the current locale's conventions for the
format of numeric quantities.
The lconv structure contains values appropriate for formatting
numeric quantities (monetary and otherwise)
according to the rules of the current locale. The members
of the structure with the type char * are pointers to
strings, any of which (except decimal_point) can point to
a null string, to indicate that the value is not available
in the current locale or is of zero length. The members
with type char are nonnegative 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:
The decimal-point character used to format nonmonetary
quantities. The separator for groups of digits to the
left of the decimal point in formatted nonmonetary quantities.
A string whose elements indicate the size of each
group of digits in formatted nonmonetary quantities. The
international currency symbol applicable to the current
locale. The first three characters of this value contain
the alphabetic international currency symbol in accordance
with those specified in ISO 4217:1987, Codes for the Representation
of Currency and Funds. The fourth character
(immediately preceding the null terminator) is the character
used to separate the international currency symbol
from the monetary quantity. The local currency symbol
applicable to the current locale. 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 whose elements indicate the
size of each group of digits in formatted monetary quantities.
The string used to indicate a nonnegative, formatted
monetary quantity. The string used to indicate a negative,
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 formatted
monetary quantity. Set to 1 if the currency_symbol or
int_curr_symbol precedes the value for a nonnegative, formatted
monetary quantity. Set to 0 (zero) if the symbol
succeeds the value. Set to 1 if the currency_symbol or
int_curr_symbol is separated by a space from the value for
a nonnegative formatted monetary quantity. Set to 0 (zero)
if the symbol is not separated by a space from the value.
Set to 2 if a space separates the symbol and the sign
string, if adjacent. Set to 1 if he currency_symbol or
int_curr_symbol precedes the value for a negative, formatted
monetary quantity. Set to 0 (zero) if the symbol succeeds
the value. Set to 1 if the currency_symbol or
int_curr_symbol is separated by a space from the value for
a negative, formatted monetary quantity. Set to 0 (zero)
if the symbol is not separated by a space from the value.
Set to 2 if a space separates the symbol and the sign
string, if adjacent. Set to a value that indicates the
positioning of the positive_sign for a nonnegative, formatted
monetary quantity. Set to a value that indicates
the positioning of the negative_sign for a negative, formatted
monetary quantity. [Tru64 UNIX] The left bracket
used to display a negative, formatted monetary quantity.
This is the locale's equivalent to the "(" (left parenthesis)
used in the C locale and is used in conjunction with
the right_parenthesis. [Tru64 UNIX] The right bracket
used to display a negative, formatted monetary quantity.
This is the locale's equivalent to the ")" (right parenthesis)
used in the C locale and is used in conjunction
with the left_parenthesis.
The elements of grouping and mon_grouping are interpreted
according to the following: No further grouping is to be
performed. The previous element is to be repeatedly used
for the remainder of the digits. 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 to the left of the current group.
The values of p_sign_posn and n_sign_posn are interpreted
according to the following: Parentheses surround the quantity
and currency_symbol or int_curr_symbol. The sign
string precedes the quantity and currency_symbol or
int_curr_symbol. The sign string succeeds the quantity
and currency_symbol or int_curr_symbol. The sign string
immediately precedes the currency_symbol or int_curr_symbol.
The sign string immediately succeeds the currency_symbol
or int_curr_symbol.
The localeconv() function returns a pointer to the filledin
object. The structure pointed to by the return value
must not be modified by the program, but can 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. No errors are defined for this
function.
Functions: nl_langinfo(3), setlocale(3), strfmon(3)
Others: i18n_intro(5), l10n_intro(5), standards(5)
Writing Software for the International Market
localeconv(3)
[ Back ] |
