locale.h.3 - scc - simple c99 compiler
(HTM) git clone git://git.simple-cc.org/scc
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) Submodules
(DIR) README
(DIR) LICENSE
---
locale.h.3 (4458B)
---
1 .TH locale.h 3
2 .SH NAME
3 locale.h - category macros
4 .SH SYNOPSIS
5 #include <locale.h>
6
7 The locale.h header declares the following functions:
8
9 .nf
10 char *setlocale(int category, const char *locale);
11 struct lconv *localeconv(void);
12 .fi
13 .SH DESCRIPTION
14 The locale.h header defines the following macros:
15
16 .nf
17 LC_ALL
18 LC_COLLATE
19 LC_CTYPE
20 LC_MESSAGES
21 LC_MONETARY
22 LC_NUMERIC
23 LC_TIME
24 .fi
25
26 These macros expand to integer constant expressions with distinct values,
27 suitable for use as the first argument,
28 .IR category ,
29 to the
30 .B setlocale
31 function.
32
33 The locale.h header declares the lconv structure defined as follows:
34
35 .nf
36 char *currency_symbol
37 char *decimal_point
38 char frac_digits
39 char *grouping
40 char *int_curr_symbol
41 char int_frac_digits
42 char int_n_cs_precedes
43 char int_n_sep_by_space
44 char int_n_sign_posn
45 char int_p_cs_precedes
46 char int_p_sep_by_space
47 char int_p_sign_posn
48 char *mon_decimal_point
49 char *mon_grouping
50 char *mon_thousands_sep
51 char *negative_sign
52 char n_cs_precedes
53 char n_sep_by_space
54 char n_sign_posn
55 char *positive_sign
56 char p_cs_precedes
57 char p_sep_by_space
58 char p_sign_posn
59 char *thousands_sep
60 .fi
61
62 The members of the
63 .I lconv
64 structure are:
65 .TP 10
66 currency_symbol
67 The local currency symbol applicable to the current locale.
68 .TP
69 decimal_point
70 The decimal-point character used to format monetary quantities.
71 .TP
72 thousands_sep
73 The character used to separate groups of digits
74 before the decimal-point character in formatted monetary quantities.
75 .TP
76 grouping
77 A string whose elements indicate the size of each group of digits in
78 formatted nonmonetary quantities.
79 .TP
80 mon_decimal_point
81 The decimal-point used to format monetary quantities.
82 .TP
83 mon_thousands_sep
84 The separator for groups of digits before
85 the decimal-point in formatted monetary quantities.
86 .TP
87 mon_grouping
88 A string whose elements indicate the size of each group of digits in
89 formatted monetary quantities.
90 .TP
91 positive_sign
92 The string used to indicate a nonnegative-valued formatted monetary
93 quantity.
94 .TP
95 negative_sign
96 The string used to indicate a negative-valued formatted
97 monetary quantity.
98 .TP
99 frac_digits
100 The number of fractional digits (those after the decimal-point)
101 to be displayed in a locally formatted monetary quantity.
102 .TP
103 p_cs_precedes
104 Set to 1 or 0 if the currency_symbol respectively precedes or
105 succeeds the value for a nonnegative locally formatted
106 monetary quantity.
107 .TP
108 n_cs_precedes
109 Set to 1 or 0 if the currency_symbol respectively precedes or
110 succeeds the value for a negative locally formatted
111 monetary quantity
112 .TP
113 p_sep_by_space
114 Set to a value indicating the separation of the currency_symbol,
115 the sign string, and the value for a nonnegative locally formatted
116 monetary quantity.
117 .TP
118 n_sep_by_space
119 Set to a value indicating the separation of the currency_symbol,
120 the sign string, and the value for a negative locally formatted
121 monetary quantity.
122 .TP
123 p_sign_posn
124 Set to a value indicating the positioning of the positive_sign for
125 a nonnegative locally formatted monetary quantity.
126 .TP
127 n_sign_posn
128 Set to a value indicating the positioning of the negative_sign for
129 a negative locally formatted monetary quantity.
130 .TP
131 int_curr_symbol
132 The international currency symbol applicable to the current locale.
133 .TP
134 int_frac_digits
135 The number of fractional digits (those after the decimal-point) to be
136 displayed in an internationally formatted monetary quantity.
137 .TP
138 int_p_cs_precedes
139 Set to 1 or 0 if the int_curr_symbol respectively precedes or
140 succeeds the value for a nonnegative internationally formatted
141 monetary quantity.
142 .TP
143 int_n_cs_precedes
144 Set to 1 or 0 if the int_curr_symbol respectively precedes or
145 succeeds the value for a negative internationally formatted
146 monetary quantity.
147 .TP
148 int_p_sep_by_space
149 Set to a value indicating the separation of the int_curr_symbol,
150 the sign string, and the value for a nonnegative internationally
151 formatted monetary quantity.
152 .TP
153 int_n_sep_by_space
154 Set to a value indicating the separation of the int_curr_symbol,
155 the sign string, and the value for a negative internationally
156 formatted monetary quantity.
157 .TP
158 int_p_sign_posn
159 Set to a value indicating the positioning of the positive_sign for
160 a nonnegative internationally formatted monetary quantity.
161 .TP
162 int_n_sign_posn
163 Set to a value indicating the positioning of the negative_sign for
164 a negative internationally formatted monetary quantity.
165 .SH STANDARDS
166 ISO/IEC 9899:1999 Section 7.11
167
168 ISO/IEC 9899:1999 Section 7.11.2.1
169 .SH SEE ALSO
170 .BR localeconv (3)
171 .BR setlocale (3)