1 | /* Copyright (C) 1991,1992,1995-2002,2007,2009,2012 |
2 | Free Software Foundation, Inc. |
3 | This file is part of the GNU C Library. |
4 | |
5 | The GNU C Library is free software; you can redistribute it and/or |
6 | modify it under the terms of the GNU Lesser General Public |
7 | License as published by the Free Software Foundation; either |
8 | version 2.1 of the License, or (at your option) any later version. |
9 | |
10 | The GNU C Library is distributed in the hope that it will be useful, |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
13 | Lesser General Public License for more details. |
14 | |
15 | You should have received a copy of the GNU Lesser General Public |
16 | License along with the GNU C Library; if not, see |
17 | <http://www.gnu.org/licenses/>. */ |
18 | |
19 | /* |
20 | * ISO C99 Standard: 7.11 Localization <locale.h> |
21 | */ |
22 | |
23 | #ifndef _LOCALE_H |
24 | #define _LOCALE_H 1 |
25 | |
26 | #include <features.h> |
27 | |
28 | #define __need_NULL |
29 | #include <stddef.h> |
30 | #include <bits/locale.h> |
31 | |
32 | __BEGIN_DECLS |
33 | |
34 | /* These are the possibilities for the first argument to setlocale. |
35 | The code assumes that the lowest LC_* symbol has the value zero. */ |
36 | #define LC_CTYPE __LC_CTYPE |
37 | #define LC_NUMERIC __LC_NUMERIC |
38 | #define LC_TIME __LC_TIME |
39 | #define LC_COLLATE __LC_COLLATE |
40 | #define LC_MONETARY __LC_MONETARY |
41 | #define LC_MESSAGES __LC_MESSAGES |
42 | #define LC_ALL __LC_ALL |
43 | #define LC_PAPER __LC_PAPER |
44 | #define LC_NAME __LC_NAME |
45 | #define LC_ADDRESS __LC_ADDRESS |
46 | #define LC_TELEPHONE __LC_TELEPHONE |
47 | #define LC_MEASUREMENT __LC_MEASUREMENT |
48 | #define LC_IDENTIFICATION __LC_IDENTIFICATION |
49 | |
50 | |
51 | __BEGIN_NAMESPACE_STD |
52 | |
53 | /* Structure giving information about numeric and monetary notation. */ |
54 | struct lconv |
55 | { |
56 | /* Numeric (non-monetary) information. */ |
57 | |
58 | char *decimal_point; /* Decimal point character. */ |
59 | char *thousands_sep; /* Thousands separator. */ |
60 | /* Each element is the number of digits in each group; |
61 | elements with higher indices are farther left. |
62 | An element with value CHAR_MAX means that no further grouping is done. |
63 | An element with value 0 means that the previous element is used |
64 | for all groups farther left. */ |
65 | char *grouping; |
66 | |
67 | /* Monetary information. */ |
68 | |
69 | /* First three chars are a currency symbol from ISO 4217. |
70 | Fourth char is the separator. Fifth char is '\0'. */ |
71 | char *int_curr_symbol; |
72 | char *currency_symbol; /* Local currency symbol. */ |
73 | char *mon_decimal_point; /* Decimal point character. */ |
74 | char *mon_thousands_sep; /* Thousands separator. */ |
75 | char *mon_grouping; /* Like `grouping' element (above). */ |
76 | char *positive_sign; /* Sign for positive values. */ |
77 | char *negative_sign; /* Sign for negative values. */ |
78 | char int_frac_digits; /* Int'l fractional digits. */ |
79 | char frac_digits; /* Local fractional digits. */ |
80 | /* 1 if currency_symbol precedes a positive value, 0 if succeeds. */ |
81 | char p_cs_precedes; |
82 | /* 1 iff a space separates currency_symbol from a positive value. */ |
83 | char p_sep_by_space; |
84 | /* 1 if currency_symbol precedes a negative value, 0 if succeeds. */ |
85 | char n_cs_precedes; |
86 | /* 1 iff a space separates currency_symbol from a negative value. */ |
87 | char n_sep_by_space; |
88 | /* Positive and negative sign positions: |
89 | 0 Parentheses surround the quantity and currency_symbol. |
90 | 1 The sign string precedes the quantity and currency_symbol. |
91 | 2 The sign string follows the quantity and currency_symbol. |
92 | 3 The sign string immediately precedes the currency_symbol. |
93 | 4 The sign string immediately follows the currency_symbol. */ |
94 | char p_sign_posn; |
95 | char n_sign_posn; |
96 | #ifdef __USE_ISOC99 |
97 | /* 1 if int_curr_symbol precedes a positive value, 0 if succeeds. */ |
98 | char int_p_cs_precedes; |
99 | /* 1 iff a space separates int_curr_symbol from a positive value. */ |
100 | char int_p_sep_by_space; |
101 | /* 1 if int_curr_symbol precedes a negative value, 0 if succeeds. */ |
102 | char int_n_cs_precedes; |
103 | /* 1 iff a space separates int_curr_symbol from a negative value. */ |
104 | char int_n_sep_by_space; |
105 | /* Positive and negative sign positions: |
106 | 0 Parentheses surround the quantity and int_curr_symbol. |
107 | 1 The sign string precedes the quantity and int_curr_symbol. |
108 | 2 The sign string follows the quantity and int_curr_symbol. |
109 | 3 The sign string immediately precedes the int_curr_symbol. |
110 | 4 The sign string immediately follows the int_curr_symbol. */ |
111 | char int_p_sign_posn; |
112 | char int_n_sign_posn; |
113 | #else |
114 | char __int_p_cs_precedes; |
115 | char __int_p_sep_by_space; |
116 | char __int_n_cs_precedes; |
117 | char __int_n_sep_by_space; |
118 | char __int_p_sign_posn; |
119 | char __int_n_sign_posn; |
120 | #endif |
121 | }; |
122 | |
123 | |
124 | /* Set and/or return the current locale. */ |
125 | extern char *setlocale (int __category, const char *__locale) __THROW; |
126 | |
127 | /* Return the numeric/monetary information for the current locale. */ |
128 | extern struct lconv *localeconv (void) __THROW; |
129 | |
130 | __END_NAMESPACE_STD |
131 | |
132 | |
133 | #ifdef __USE_XOPEN2K8 |
134 | /* The concept of one static locale per category is not very well |
135 | thought out. Many applications will need to process its data using |
136 | information from several different locales. Another application is |
137 | the implementation of the internationalization handling in the |
138 | upcoming ISO C++ standard library. To support this another set of |
139 | the functions using locale data exist which have an additional |
140 | argument. |
141 | |
142 | Attention: all these functions are *not* standardized in any form. |
143 | This is a proof-of-concept implementation. */ |
144 | |
145 | /* Get locale datatype definition. */ |
146 | # include <xlocale.h> |
147 | |
148 | /* Return a reference to a data structure representing a set of locale |
149 | datasets. Unlike for the CATEGORY parameter for `setlocale' the |
150 | CATEGORY_MASK parameter here uses a single bit for each category, |
151 | made by OR'ing together LC_*_MASK bits above. */ |
152 | extern __locale_t newlocale (int __category_mask, const char *__locale, |
153 | __locale_t __base) __THROW; |
154 | |
155 | /* These are the bits that can be set in the CATEGORY_MASK argument to |
156 | `newlocale'. In the GNU implementation, LC_FOO_MASK has the value |
157 | of (1 << LC_FOO), but this is not a part of the interface that |
158 | callers can assume will be true. */ |
159 | # define LC_CTYPE_MASK (1 << __LC_CTYPE) |
160 | # define LC_NUMERIC_MASK (1 << __LC_NUMERIC) |
161 | # define LC_TIME_MASK (1 << __LC_TIME) |
162 | # define LC_COLLATE_MASK (1 << __LC_COLLATE) |
163 | # define LC_MONETARY_MASK (1 << __LC_MONETARY) |
164 | # define LC_MESSAGES_MASK (1 << __LC_MESSAGES) |
165 | # define LC_PAPER_MASK (1 << __LC_PAPER) |
166 | # define LC_NAME_MASK (1 << __LC_NAME) |
167 | # define LC_ADDRESS_MASK (1 << __LC_ADDRESS) |
168 | # define LC_TELEPHONE_MASK (1 << __LC_TELEPHONE) |
169 | # define LC_MEASUREMENT_MASK (1 << __LC_MEASUREMENT) |
170 | # define LC_IDENTIFICATION_MASK (1 << __LC_IDENTIFICATION) |
171 | # define LC_ALL_MASK (LC_CTYPE_MASK \ |
172 | | LC_NUMERIC_MASK \ |
173 | | LC_TIME_MASK \ |
174 | | LC_COLLATE_MASK \ |
175 | | LC_MONETARY_MASK \ |
176 | | LC_MESSAGES_MASK \ |
177 | | LC_PAPER_MASK \ |
178 | | LC_NAME_MASK \ |
179 | | LC_ADDRESS_MASK \ |
180 | | LC_TELEPHONE_MASK \ |
181 | | LC_MEASUREMENT_MASK \ |
182 | | LC_IDENTIFICATION_MASK \ |
183 | ) |
184 | |
185 | /* Return a duplicate of the set of locale in DATASET. All usage |
186 | counters are increased if necessary. */ |
187 | extern __locale_t duplocale (__locale_t __dataset) __THROW; |
188 | |
189 | /* Free the data associated with a locale dataset previously returned |
190 | by a call to `setlocale_r'. */ |
191 | extern void freelocale (__locale_t __dataset) __THROW; |
192 | |
193 | /* Switch the current thread's locale to DATASET. |
194 | If DATASET is null, instead just return the current setting. |
195 | The special value LC_GLOBAL_LOCALE is the initial setting |
196 | for all threads and can also be installed any time, meaning |
197 | the thread uses the global settings controlled by `setlocale'. */ |
198 | extern __locale_t uselocale (__locale_t __dataset) __THROW; |
199 | |
200 | /* This value can be passed to `uselocale' and may be returned by it. |
201 | Passing this value to any other function has undefined behavior. */ |
202 | # define LC_GLOBAL_LOCALE ((__locale_t) -1L) |
203 | |
204 | #endif |
205 | |
206 | __END_DECLS |
207 | |
208 | #endif /* locale.h */ |
209 | |