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