1 /* A POSIX <locale.h>.
2 Copyright (C) 2007-2021 Free Software Foundation, Inc.
3
4 This file is free software: you can redistribute it and/or modify
5 it under the terms of the GNU Lesser General Public License as
6 published by the Free Software Foundation; either version 2.1 of the
7 License, or (at your option) any later version.
8
9 This file 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
12 GNU Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public License
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
16
17 #if __GNUC__ >= 3
18 @PRAGMA_SYSTEM_HEADER@
19 #endif
20 @PRAGMA_COLUMNS@
21
22 #if (defined _WIN32 && !defined __CYGWIN__ && defined __need_locale_t) \
23 || defined _GL_ALREADY_INCLUDING_LOCALE_H
24
25 /* Special invocation convention:
26 - Inside mingw header files,
27 - To handle Solaris header files (through Solaris 10) when combined
28 with gettext's libintl.h. */
29
30 #@INCLUDE_NEXT@ @NEXT_LOCALE_H@
31
32 #else
33 /* Normal invocation convention. */
34
35 #ifndef _@GUARD_PREFIX@_LOCALE_H
36
37 #define _GL_ALREADY_INCLUDING_LOCALE_H
38
39 /* The include_next requires a split double-inclusion guard. */
40 #@INCLUDE_NEXT@ @NEXT_LOCALE_H@
41
42 #undef _GL_ALREADY_INCLUDING_LOCALE_H
43
44 #ifndef _@GUARD_PREFIX@_LOCALE_H
45 #define _@GUARD_PREFIX@_LOCALE_H
46
47 /* NetBSD 5.0 mis-defines NULL. */
48 #include <stddef.h>
49
50 /* Mac OS X 10.5 defines the locale_t type in <xlocale.h>. */
51 #if @HAVE_XLOCALE_H@
52 # include <xlocale.h>
53 #endif
54
55 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here. */
56
57 /* The definition of _GL_ARG_NONNULL is copied here. */
58
59 /* The definition of _GL_WARN_ON_USE is copied here. */
60
61 /* The LC_MESSAGES locale category is specified in POSIX, but not in ISO C.
62 On systems that don't define it, use the same value as GNU libintl. */
63 #if !defined LC_MESSAGES
64 # define LC_MESSAGES 1729
65 #endif
66
67 /* On native Windows with MSVC, 'struct lconv' lacks the members int_p_* and
68 int_n_*. Instead of overriding 'struct lconv', merely define these member
69 names as macros. This avoids trouble in C++ mode. */
70 #if defined _MSC_VER
71 # define int_p_cs_precedes p_cs_precedes
72 # define int_p_sign_posn p_sign_posn
73 # define int_p_sep_by_space p_sep_by_space
74 # define int_n_cs_precedes n_cs_precedes
75 # define int_n_sign_posn n_sign_posn
76 # define int_n_sep_by_space n_sep_by_space
77 #endif
78
79 /* Bionic libc's 'struct lconv' is just a dummy. */
80 #if @REPLACE_STRUCT_LCONV@
81 # define lconv rpl_lconv
82 struct lconv
83 {
84 /* All 'char *' are actually 'const char *'. */
85
86 /* Members that depend on the LC_NUMERIC category of the locale. See
87 <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html#tag_07_03_04> */
88
89 /* Symbol used as decimal point. */
90 char *decimal_point;
91 /* Symbol used to separate groups of digits to the left of the decimal
92 point. */
93 char *thousands_sep;
94 /* Definition of the size of groups of digits to the left of the decimal
95 point. */
96 char *grouping;
97
98 /* Members that depend on the LC_MONETARY category of the locale. See
99 <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html#tag_07_03_03> */
100
101 /* Symbol used as decimal point. */
102 char *mon_decimal_point;
103 /* Symbol used to separate groups of digits to the left of the decimal
104 point. */
105 char *mon_thousands_sep;
106 /* Definition of the size of groups of digits to the left of the decimal
107 point. */
108 char *mon_grouping;
109 /* Sign used to indicate a value >= 0. */
110 char *positive_sign;
111 /* Sign used to indicate a value < 0. */
112 char *negative_sign;
113
114 /* For formatting local currency. */
115 /* Currency symbol (3 characters) followed by separator (1 character). */
116 char *currency_symbol;
117 /* Number of digits after the decimal point. */
118 char frac_digits;
119 /* For values >= 0: 1 if the currency symbol precedes the number, 0 if it
120 comes after the number. */
121 char p_cs_precedes;
122 /* For values >= 0: Position of the sign. */
123 char p_sign_posn;
124 /* For values >= 0: Placement of spaces between currency symbol, sign, and
125 number. */
126 char p_sep_by_space;
127 /* For values < 0: 1 if the currency symbol precedes the number, 0 if it
128 comes after the number. */
129 char n_cs_precedes;
130 /* For values < 0: Position of the sign. */
131 char n_sign_posn;
132 /* For values < 0: Placement of spaces between currency symbol, sign, and
133 number. */
134 char n_sep_by_space;
135
136 /* For formatting international currency. */
137 /* Currency symbol (3 characters) followed by separator (1 character). */
138 char *int_curr_symbol;
139 /* Number of digits after the decimal point. */
140 char int_frac_digits;
141 /* For values >= 0: 1 if the currency symbol precedes the number, 0 if it
142 comes after the number. */
143 char int_p_cs_precedes;
144 /* For values >= 0: Position of the sign. */
145 char int_p_sign_posn;
146 /* For values >= 0: Placement of spaces between currency symbol, sign, and
147 number. */
148 char int_p_sep_by_space;
149 /* For values < 0: 1 if the currency symbol precedes the number, 0 if it
150 comes after the number. */
151 char int_n_cs_precedes;
152 /* For values < 0: Position of the sign. */
153 char int_n_sign_posn;
154 /* For values < 0: Placement of spaces between currency symbol, sign, and
155 number. */
156 char int_n_sep_by_space;
157 };
158 #endif
159
160 #if @GNULIB_LOCALECONV@
161 # if @REPLACE_LOCALECONV@
162 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
163 # undef localeconv
164 # define localeconv rpl_localeconv
165 # endif
166 _GL_FUNCDECL_RPL (localeconv, struct lconv *, (void));
167 _GL_CXXALIAS_RPL (localeconv, struct lconv *, (void));
168 # else
169 _GL_CXXALIAS_SYS (localeconv, struct lconv *, (void));
170 # endif
171 # if __GLIBC__ >= 2
172 _GL_CXXALIASWARN (localeconv);
173 # endif
174 #elif @REPLACE_STRUCT_LCONV@
175 # undef localeconv
176 # define localeconv localeconv_used_without_requesting_gnulib_module_localeconv
177 #elif defined GNULIB_POSIXCHECK
178 # undef localeconv
179 # if HAVE_RAW_DECL_LOCALECONV
180 _GL_WARN_ON_USE (localeconv,
181 "localeconv returns too few information on some platforms - "
182 "use gnulib module localeconv for portability");
183 # endif
184 #endif
185
186 #if @GNULIB_SETLOCALE@
187 # if @REPLACE_SETLOCALE@
188 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
189 # undef setlocale
190 # define setlocale rpl_setlocale
191 # define GNULIB_defined_setlocale 1
192 # endif
193 _GL_FUNCDECL_RPL (setlocale, char *, (int category, const char *locale));
194 _GL_CXXALIAS_RPL (setlocale, char *, (int category, const char *locale));
195 # else
196 _GL_CXXALIAS_SYS (setlocale, char *, (int category, const char *locale));
197 # endif
198 # if __GLIBC__ >= 2
199 _GL_CXXALIASWARN (setlocale);
200 # endif
201 #elif defined GNULIB_POSIXCHECK
202 # undef setlocale
203 # if HAVE_RAW_DECL_SETLOCALE
204 _GL_WARN_ON_USE (setlocale, "setlocale works differently on native Windows - "
205 "use gnulib module setlocale for portability");
206 # endif
207 #endif
208
209 #if @GNULIB_SETLOCALE_NULL@
210 /* Included here for convenience. */
211 # include "setlocale_null.h"
212 #endif
213
214 #if /*@GNULIB_NEWLOCALE@ ||*/ (@GNULIB_LOCALENAME@ && @LOCALENAME_ENHANCE_LOCALE_FUNCS@ && @HAVE_NEWLOCALE@)
215 # if @REPLACE_NEWLOCALE@
216 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
217 # undef newlocale
218 # define newlocale rpl_newlocale
219 # define GNULIB_defined_newlocale 1
220 # endif
221 _GL_FUNCDECL_RPL (newlocale, locale_t,
222 (int category_mask, const char *name, locale_t base)
223 _GL_ARG_NONNULL ((2)));
224 _GL_CXXALIAS_RPL (newlocale, locale_t,
225 (int category_mask, const char *name, locale_t base));
226 # else
227 # if @HAVE_NEWLOCALE@
228 _GL_CXXALIAS_SYS (newlocale, locale_t,
229 (int category_mask, const char *name, locale_t base));
230 # endif
231 # endif
232 # if @HAVE_NEWLOCALE@
233 _GL_CXXALIASWARN (newlocale);
234 # endif
235 # if @HAVE_NEWLOCALE@ || @REPLACE_NEWLOCALE@
236 # ifndef HAVE_WORKING_NEWLOCALE
237 # define HAVE_WORKING_NEWLOCALE 1
238 # endif
239 # endif
240 #elif defined GNULIB_POSIXCHECK
241 # undef newlocale
242 # if HAVE_RAW_DECL_NEWLOCALE
243 _GL_WARN_ON_USE (newlocale, "newlocale is not portable");
244 # endif
245 #endif
246
247 #if @GNULIB_DUPLOCALE@ || (@GNULIB_LOCALENAME@ && @LOCALENAME_ENHANCE_LOCALE_FUNCS@ && @HAVE_DUPLOCALE@)
248 # if @REPLACE_DUPLOCALE@
249 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
250 # undef duplocale
251 # define duplocale rpl_duplocale
252 # define GNULIB_defined_duplocale 1
253 # endif
254 _GL_FUNCDECL_RPL (duplocale, locale_t, (locale_t locale) _GL_ARG_NONNULL ((1)));
255 _GL_CXXALIAS_RPL (duplocale, locale_t, (locale_t locale));
256 # else
257 # if @HAVE_DUPLOCALE@
258 _GL_CXXALIAS_SYS (duplocale, locale_t, (locale_t locale));
259 # endif
260 # endif
261 # if @HAVE_DUPLOCALE@
262 _GL_CXXALIASWARN (duplocale);
263 # endif
264 # if @HAVE_DUPLOCALE@ || @REPLACE_DUPLOCALE@
265 # ifndef HAVE_WORKING_DUPLOCALE
266 # define HAVE_WORKING_DUPLOCALE 1
267 # endif
268 # endif
269 #elif defined GNULIB_POSIXCHECK
270 # undef duplocale
271 # if HAVE_RAW_DECL_DUPLOCALE
272 _GL_WARN_ON_USE (duplocale, "duplocale is buggy on some glibc systems - "
273 "use gnulib module duplocale for portability");
274 # endif
275 #endif
276
277 #if /*@GNULIB_FREELOCALE@ ||*/ (@GNULIB_LOCALENAME@ && @LOCALENAME_ENHANCE_LOCALE_FUNCS@ && @HAVE_FREELOCALE@)
278 # if @REPLACE_FREELOCALE@
279 # if !(defined __cplusplus && defined GNULIB_NAMESPACE)
280 # undef freelocale
281 # define freelocale rpl_freelocale
282 # define GNULIB_defined_freelocale 1
283 # endif
284 _GL_FUNCDECL_RPL (freelocale, void, (locale_t locale) _GL_ARG_NONNULL ((1)));
285 _GL_CXXALIAS_RPL (freelocale, void, (locale_t locale));
286 # else
287 # if @HAVE_FREELOCALE@
288 /* Need to cast, because on FreeBSD and Mac OS X 10.13, the return type is
289 int. */
290 _GL_CXXALIAS_SYS_CAST (freelocale, void, (locale_t locale));
291 # endif
292 # endif
293 # if @HAVE_FREELOCALE@
294 _GL_CXXALIASWARN (freelocale);
295 # endif
296 #elif defined GNULIB_POSIXCHECK
297 # undef freelocale
298 # if HAVE_RAW_DECL_FREELOCALE
299 _GL_WARN_ON_USE (freelocale, "freelocale is not portable");
300 # endif
301 #endif
302
303 #endif /* _@GUARD_PREFIX@_LOCALE_H */
304 #endif /* _@GUARD_PREFIX@_LOCALE_H */
305 #endif /* !(__need_locale_t || _GL_ALREADY_INCLUDING_LOCALE_H) */