 |
Index for
Section 3 |
|
 |
Alphabetical
listing for L |
|
 |
Bottom of
page |
|
localeconv(3)
NAME
localeconv - Retrieve locale-dependent formatting parameters
SYNOPSIS
#include <locale.h>
struct lconv *localeconv(
void );
LIBRARY
Standard C Library (libc)
STANDARDS
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.
DESCRIPTION
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:
char *decimal_point
The decimal-point character used to format nonmonetary quantities.
char *thousands_sep
The separator for groups of digits to the left of the decimal point in
formatted nonmonetary quantities.
char *grouping
A string whose elements indicate the size of each group of digits in
formatted nonmonetary quantities.
char *int_curr_symbol
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.
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 to the left of the decimal 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, formatted monetary quantity.
char *negative_sign
The string used to indicate a negative, formatted monetary quantity.
char int_frac_digits
The number of fractional digits (those to the right of the decimal
point) to be displayed in an internationally formatted monetary
quantity.
char frac_digits
The number of fractional digits (those to the right of the decimal
point) to be displayed in a formatted monetary quantity.
char p_cs_precedes
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.
char p_sep_by_space
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.
char n_cs_precedes
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.
char n_sep_by_space
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.
char p_sign_posn
Set to a value that indicates the positioning of the positive_sign for
a nonnegative, formatted monetary quantity.
char n_sign_posn
Set to a value that indicates the positioning of the negative_sign for
a negative, formatted monetary quantity.
char* left_parenthesis
[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.
char* 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:
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 to the left of the current group.
The values of p_sign_posn and n_sign_posn are interpreted according to the
following:
0 Parentheses surround the quantity and currency_symbol or
int_curr_symbol.
1 The sign string precedes the quantity and currency_symbol or
int_curr_symbol.
2 The sign string succeeds the quantity and currency_symbol or
int_curr_symbol.
3 The sign string immediately precedes the currency_symbol or
int_curr_symbol.
4 The sign string immediately succeeds the currency_symbol or
int_curr_symbol.
RETURN VALUES
The localeconv() function returns a pointer to the filled-in 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.
SEE ALSO
Functions: nl_langinfo(3), setlocale(3), strfmon(3)
Others: i18n_intro(5), l10n_intro(5), standards(5)
Writing Software for the International Market
|
Index for
Section 3 |
|
|
Alphabetical
listing for L |
|
 |
Top of
page |
|