montbl(1M)
NAME
montbl − create monetary database
SYNOPSIS
montbl [ −o outfile] infile
DESCRIPTION
The montbl command takes as input a specification file, infile, that describes the formatting conventions for monetary quantities for a specific locale.
The output of montbl is suitable for use by the localeconv(3C) function. Before outfile can be used by localeconv(), it must be installed in the /usr/lib/locale/locale directory with the name LC_MONETARY by the super-user. locale is the locale whose monetary formatting conventions are described in infile. This file must be readable by user, group, and other; no other permissions should be set. To use formatting conventions for monetary quantities described in this file, use setlocale(3C) to change the locale for category LC_MONETARY to locale.
Once installed, this file will be used by the localeconv() function to initialize the monetary specific fields of a structure of type struct lconv. For a description of the fields in this structure, see localeconv(3C).
struct lconv {
char ∗decimal_point;/∗ "" (zero length string) ∗/
char ∗thousands_sep;/∗ "" (zero length string) ∗/
char ∗grouping;/∗ "" ∗/
char ∗int_curr_symbol;/∗ "" ∗/
char ∗currency_symbol;/∗ "" ∗/
char ∗mon_decimal_point;/∗ "" ∗/
char ∗mon_thousands_sep; /∗ "" ∗/
char ∗mon_grouping;/∗ "" ∗/
char ∗positive_sign;/∗ "" ∗/
char ∗negative_sign;/∗ "" ∗/
char int_frac_digits;/∗ CHAR_MAX ∗/
char frac_digits;/∗ CHAR_MAX ∗/
char p_cs_precedes;/∗ CHAR_MAX ∗/
char p_sep_by_space;/∗ CHAR_MAX ∗/
char n_cs_precedes;/∗ CHAR_MAX ∗/
char n_sep_by_space;/∗ CHAR_MAX ∗/
char p_sign_posn;/∗ CHAR_MAX ∗/
char n_sign_posn;/∗ CHAR_MAX ∗/
};
The specification file specifies the value of each struct lconv member, except for the first two members, decimal_point and thousands_sep, which are set by the LC_NUMERIC category of setlocale(3C). Each member’s value is given on a line in the order defined in the lconv structure.
Blank lines and lines starting with a # are comments and are ignored. A character in a string may be in octal or hex representation. For example, \141 or \x61 could be used to represent the letter ’a’. If there is no specification line for a given structure member, then the default ’C’ locale value for that member is used (see the values in the comments in the struct lconv definition above). Here is a specification file for Japan:
# first eight items have string values, remaining items have numeric values.
# grouping=
3
# int_curr_symbol=
JPY
# currency_symbol=
\xa1\xef
# mon_decimal_point=
.
# mon_thousands_sep=
,
# mon_grouping=
3
# positive_sign=
# negative_sign=
−
# int_frac_digits=
0
# frac_digits=
0
# p_cs_precedes=
1
# p_sep_by_space=
0
# n_cs_precedes=
1
# n_sep_by_space=
0
# p_sign_posn=
1
# n_sign_posn=
4
OPTIONS
−o outfile Write output to outfile; otherwise, write output to LC_MONETARY.
FILES
/usr/lib/locale/locale/LC_MONETARY
LC_MONETARY database for locale
SEE ALSO
NOTES
Do not change files under the C locale, as this could cause undefined or nonstandard behavior.
SunOS 5.1 — Last change: 12 Nov 1991