Subversion Repositories or1k

@node Locale

@chapter Locale (@file{locale.h})

A @dfn{locale} is the name for a collection of parameters (affecting

collating sequences and formatting conventions) that may be different

depending on location or culture.  The @code{"C"} locale is the only

one defined in the ANSI C standard.

This is a minimal implementation, supporting only the required @code{``C''}

value for locale; strings representing other locales are not

honored.  (@code{``''} is also accepted; it represents the default locale

for an implementation, here equivalent to  @code{``C''}.

@file{locale.h} defines the structure @code{lconv} to collect the

information on a locale, with the following fields:

@table @code

@item char *decimal_point

The decimal point character used to format ``ordinary'' numbers (all

numbers except those referring to amounts of money).  @code{``.''} in the

C locale.

@item char *thousands_sep

The character (if any) used to separate groups of digits, when

formatting ordinary numbers.

@code{``''} in the C locale.

@item char *grouping

Specifications for how many digits to group (if any grouping is done at

all) when formatting ordinary numbers.  The @emph{numeric value} of each

character in the string represents the number of digits for the next

group, and a value of @code{0} (that is, the string's trailing

@code{NULL}) means to continue grouping digits using the last value

specified.  Use @code{CHAR_MAX} to indicate that no further grouping is

desired.  @code{``''} in the C locale.

@item char *int_curr_symbol

The international currency symbol (first three characters), if any, and

the character used to separate it from numbers.

@code{``''} in the C locale.

@item char *currency_symbol

The local currency symbol, if any.

@code{``''} in the C locale.

@item char *mon_decimal_point

The symbol used to delimit fractions in amounts of money.

@code{``''} in the C locale.

@item char *mon_thousands_sep

Similar to @code{thousands_sep}, but used for amounts of money.

@code{``''} in the C locale.

@item char *mon_grouping

Similar to @code{grouping}, but used for amounts of money.

@code{``''} in the C locale.

@item char *positive_sign

A string to flag positive amounts of money when formatting.

@code{``''} in the C locale.

@item char *negative_sign

A string to flag negative amounts of money when formatting.

@code{``''} in the C locale.

@item char int_frac_digits

The number of digits to display when formatting amounts of money to

international conventions.

@code{CHAR_MAX} (the largest number representable as a @code{char}) in

the C locale.

@item char frac_digits

The number of digits to display when formatting amounts of money to

local conventions.

@code{CHAR_MAX} in the C locale.

@item char p_cs_precedes

@code{1} indicates the local currency symbol is used before a

@emph{positive or zero} formatted amount of money; @code{0} indicates

the currency symbol is placed after the formatted number.

@code{CHAR_MAX} in the C locale.

@item char p_sep_by_space

@code{1} indicates the local currency symbol must be separated from

@emph{positive or zero} numbers by a space; @code{0} indicates that it

is immediately adjacent to numbers.

@code{CHAR_MAX} in the C locale.

@item char n_cs_precedes

@code{1} indicates the local currency symbol is used before a

@emph{negative} formatted amount of money; @code{0} indicates

the currency symbol is placed after the formatted number.

@code{CHAR_MAX} in the C locale.

@item char n_sep_by_space

@code{1} indicates the local currency symbol must be separated from

@emph{negative} numbers by a space; @code{0} indicates that it

is immediately adjacent to numbers.

@code{CHAR_MAX} in the C locale.

@item char p_sign_posn

Controls the position of the @emph{positive} sign for

numbers representing money.  @code{0} means parentheses surround the

number; @code{1} means the sign is placed before both the number and the

currency symbol; @code{2} means the sign is placed after both the number

and the currency symbol; @code{3} means the sign is placed just before

the currency symbol; and @code{4} means the sign is placed just after

the currency symbol.

@code{CHAR_MAX} in the C locale.

@item char n_sign_posn

Controls the position of the @emph{negative} sign for numbers

representing money, using the same rules as @code{p_sign_posn}.

@code{CHAR_MAX} in the C locale.

@end table

@menu

* setlocale::  Select or query locale

@end menu

@page

@include locale/locale.def