
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Watcom C Library Reference - <u>synopsis:</u>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Synopsis:
#include <locale.h>
struct lconv *localeconv( void );
Description:
The localeconv function sets the components of an object of type struct
lconv with values appropriate for the formatting of numeric quantities
according to the current locale. The components of the struct lconv
and their meanings are as follows:
Component Meaning
char *decimal_point
The decimal-point character used to format non-monetary quantities.
char *thousands_sep
The character used to separate groups of digits to the left of 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 character (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 character used to format monetary quantities.
char *mon_thousands_sep
The character used to separate groups of digits to the left of the
decimal-point character 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 monetary quantity.
char *negative_sign
The string used to indicate a negative-valued 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 or 0 if the currency_symbol respectively precedes or follows
the value for a nonnegative formatted 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 nonnegative formatted monetary
quantity.
char n_cs_precedes
Set to 1 or 0 if the currency_symbol respectively precedes or follows
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 negative formatted monetary
quantity.
char p_sign_posn
The position of the positive_sign for a nonnegative formatted monetary
quantity.
char n_sign_posn
The position of the positive_sign for a negative formatted monetary
quantity.
The elements of grouping and mon_grouping are interpreted according to
the following:
Value Meaning
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 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 value of p_sign_posn and n_sign_posn is interpreted as follows:
Value Meaning
0
Parentheses surround the quantity and currency_symbol.
1
The sign string precedes the quantity and currency_symbol.
2
The sign string follows the quantity and currency_symbol.
3
The sign string immediately precedes the quantity and currency_symbol.
4
The sign string immediately follows the quantity and currency_symbol.
Returns:
The localeconv function returns a pointer to the filled-in object.
Example:
#include <stdio.h>
#include <locale.h>
void main()
{
struct lconv *lc;
lc = localeconv();
printf( "*decimal_point (%s)\n",
lc->decimal_point );
printf( "*thousands_sep (%s)\n",
lc->thousands_sep );
printf( "*int_curr_symbol (%s)\n",
lc->int_curr_symbol );
printf( "*currency_symbol (%s)\n",
lc->currency_symbol );
printf( "*mon_decimal_point (%s)\n",
lc->mon_decimal_point );
printf( "*mon_thousands_sep (%s)\n",
lc->mon_thousands_sep );
printf( "*mon_grouping (%s)\n",
lc->mon_grouping );
printf( "*grouping (%s)\n",
lc->grouping );
printf( "*positive_sign (%s)\n",
lc->positive_sign );
printf( "*negative_sign (%s)\n",
lc->negative_sign );
printf( "int_frac_digits (%d)\n",
lc->int_frac_digits );
printf( "frac_digits (%d)\n",
lc->frac_digits );
printf( "p_cs_precedes (%d)\n",
lc->p_cs_precedes );
printf( "p_sep_by_space (%d)\n",
lc->p_sep_by_space );
printf( "n_cs_precedes (%d)\n",
lc->n_cs_precedes );
printf( "n_sep_by_space (%d)\n",
lc->n_sep_by_space );
printf( "p_sign_posn (%d)\n",
lc->p_sign_posn );
printf( "n_sign_posn (%d)\n",
lc->n_sign_posn );
}
Classification:
ANSI
Systems:
All, Netware
See Also:
setlocale
See Also:
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson