]>
Commit | Line | Data |
---|---|---|
b0cacab0 TT |
1 | /* Message catalogs for internationalization. |
2 | Copyright (C) 1995-1997, 2000-2003 Free Software Foundation, Inc. | |
3 | ||
4 | This program is free software; you can redistribute it and/or modify it | |
5 | under the terms of the GNU Library General Public License as published | |
6 | by the Free Software Foundation; either version 2, or (at your option) | |
7 | any later version. | |
8 | ||
9 | This program 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 | Library General Public License for more details. | |
13 | ||
14 | You should have received a copy of the GNU Library General Public | |
15 | License along with this program; if not, write to the Free Software | |
16 | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, | |
17 | USA. */ | |
18 | ||
19 | #ifndef _LIBINTL_H | |
20 | #define _LIBINTL_H 1 | |
21 | ||
22 | #include <locale.h> | |
23 | ||
24 | /* The LC_MESSAGES locale category is the category used by the functions | |
25 | gettext() and dgettext(). It is specified in POSIX, but not in ANSI C. | |
26 | On systems that don't define it, use an arbitrary value instead. | |
27 | On Solaris, <locale.h> defines __LOCALE_H (or _LOCALE_H in Solaris 2.5) | |
28 | then includes <libintl.h> (i.e. this file!) and then only defines | |
29 | LC_MESSAGES. To avoid a redefinition warning, don't define LC_MESSAGES | |
30 | in this case. */ | |
31 | #if !defined LC_MESSAGES && !(defined __LOCALE_H || (defined _LOCALE_H && defined __sun)) | |
32 | # define LC_MESSAGES 1729 | |
33 | #endif | |
34 | ||
35 | /* We define an additional symbol to signal that we use the GNU | |
36 | implementation of gettext. */ | |
37 | #define __USE_GNU_GETTEXT 1 | |
38 | ||
39 | /* Provide information about the supported file formats. Returns the | |
40 | maximum minor revision number supported for a given major revision. */ | |
41 | #define __GNU_GETTEXT_SUPPORTED_REVISION(major) \ | |
42 | ((major) == 0 ? 1 : -1) | |
43 | ||
44 | /* Resolve a platform specific conflict on DJGPP. GNU gettext takes | |
45 | precedence over _conio_gettext. */ | |
46 | #ifdef __DJGPP__ | |
47 | # undef gettext | |
48 | #endif | |
49 | ||
50 | #ifdef __cplusplus | |
51 | extern "C" { | |
52 | #endif | |
53 | ||
54 | ||
55 | /* We redirect the functions to those prefixed with "libintl_". This is | |
56 | necessary, because some systems define gettext/textdomain/... in the C | |
57 | library (namely, Solaris 2.4 and newer, and GNU libc 2.0 and newer). | |
58 | If we used the unprefixed names, there would be cases where the | |
59 | definition in the C library would override the one in the libintl.so | |
60 | shared library. Recall that on ELF systems, the symbols are looked | |
61 | up in the following order: | |
62 | 1. in the executable, | |
63 | 2. in the shared libraries specified on the link command line, in order, | |
64 | 3. in the dependencies of the shared libraries specified on the link | |
65 | command line, | |
66 | 4. in the dlopen()ed shared libraries, in the order in which they were | |
67 | dlopen()ed. | |
68 | The definition in the C library would override the one in libintl.so if | |
69 | either | |
70 | * -lc is given on the link command line and -lintl isn't, or | |
71 | * -lc is given on the link command line before -lintl, or | |
72 | * libintl.so is a dependency of a dlopen()ed shared library but not | |
73 | linked to the executable at link time. | |
74 | Since Solaris gettext() behaves differently than GNU gettext(), this | |
75 | would be unacceptable. | |
76 | ||
77 | The redirection happens by default through macros in C, so that &gettext | |
78 | is independent of the compilation unit, but through inline functions in | |
79 | C++, in order not to interfere with the name mangling of class fields or | |
80 | class methods called 'gettext'. */ | |
81 | ||
82 | /* The user can define _INTL_REDIRECT_INLINE or _INTL_REDIRECT_MACROS. | |
83 | If he doesn't, we choose the method. A third possible method is | |
84 | _INTL_REDIRECT_ASM, supported only by GCC. */ | |
85 | #if !(defined _INTL_REDIRECT_INLINE || defined _INTL_REDIRECT_MACROS) | |
86 | # if __GNUC__ >= 2 && !defined __APPLE_CC__ && !defined __MINGW32__ && !(__GNUC__ == 2 && defined _AIX) && (defined __STDC__ || defined __cplusplus) | |
87 | # define _INTL_REDIRECT_ASM | |
88 | # else | |
89 | # ifdef __cplusplus | |
90 | # define _INTL_REDIRECT_INLINE | |
91 | # else | |
92 | # define _INTL_REDIRECT_MACROS | |
93 | # endif | |
94 | # endif | |
95 | #endif | |
96 | /* Auxiliary macros. */ | |
97 | #ifdef _INTL_REDIRECT_ASM | |
98 | # define _INTL_ASM(cname) __asm__ (_INTL_ASMNAME (__USER_LABEL_PREFIX__, #cname)) | |
99 | # define _INTL_ASMNAME(prefix,cnamestring) _INTL_STRINGIFY (prefix) cnamestring | |
100 | # define _INTL_STRINGIFY(prefix) #prefix | |
101 | #else | |
102 | # define _INTL_ASM(cname) | |
103 | #endif | |
104 | ||
105 | /* Look up MSGID in the current default message catalog for the current | |
106 | LC_MESSAGES locale. If not found, returns MSGID itself (the default | |
107 | text). */ | |
108 | #ifdef _INTL_REDIRECT_INLINE | |
109 | extern char *libintl_gettext (const char *__msgid); | |
110 | static inline char *gettext (const char *__msgid) | |
111 | { | |
112 | return libintl_gettext (__msgid); | |
113 | } | |
114 | #else | |
115 | #ifdef _INTL_REDIRECT_MACROS | |
116 | # define gettext libintl_gettext | |
117 | #endif | |
118 | extern char *gettext (const char *__msgid) | |
119 | _INTL_ASM (libintl_gettext); | |
120 | #endif | |
121 | ||
122 | /* Look up MSGID in the DOMAINNAME message catalog for the current | |
123 | LC_MESSAGES locale. */ | |
124 | #ifdef _INTL_REDIRECT_INLINE | |
125 | extern char *libintl_dgettext (const char *__domainname, const char *__msgid); | |
126 | static inline char *dgettext (const char *__domainname, const char *__msgid) | |
127 | { | |
128 | return libintl_dgettext (__domainname, __msgid); | |
129 | } | |
130 | #else | |
131 | #ifdef _INTL_REDIRECT_MACROS | |
132 | # define dgettext libintl_dgettext | |
133 | #endif | |
134 | extern char *dgettext (const char *__domainname, const char *__msgid) | |
135 | _INTL_ASM (libintl_dgettext); | |
136 | #endif | |
137 | ||
138 | /* Look up MSGID in the DOMAINNAME message catalog for the current CATEGORY | |
139 | locale. */ | |
140 | #ifdef _INTL_REDIRECT_INLINE | |
141 | extern char *libintl_dcgettext (const char *__domainname, const char *__msgid, | |
142 | int __category); | |
143 | static inline char *dcgettext (const char *__domainname, const char *__msgid, | |
144 | int __category) | |
145 | { | |
146 | return libintl_dcgettext (__domainname, __msgid, __category); | |
147 | } | |
148 | #else | |
149 | #ifdef _INTL_REDIRECT_MACROS | |
150 | # define dcgettext libintl_dcgettext | |
151 | #endif | |
152 | extern char *dcgettext (const char *__domainname, const char *__msgid, | |
153 | int __category) | |
154 | _INTL_ASM (libintl_dcgettext); | |
155 | #endif | |
156 | ||
157 | ||
158 | /* Similar to `gettext' but select the plural form corresponding to the | |
159 | number N. */ | |
160 | #ifdef _INTL_REDIRECT_INLINE | |
161 | extern char *libintl_ngettext (const char *__msgid1, const char *__msgid2, | |
162 | unsigned long int __n); | |
163 | static inline char *ngettext (const char *__msgid1, const char *__msgid2, | |
164 | unsigned long int __n) | |
165 | { | |
166 | return libintl_ngettext (__msgid1, __msgid2, __n); | |
167 | } | |
168 | #else | |
169 | #ifdef _INTL_REDIRECT_MACROS | |
170 | # define ngettext libintl_ngettext | |
171 | #endif | |
172 | extern char *ngettext (const char *__msgid1, const char *__msgid2, | |
173 | unsigned long int __n) | |
174 | _INTL_ASM (libintl_ngettext); | |
175 | #endif | |
176 | ||
177 | /* Similar to `dgettext' but select the plural form corresponding to the | |
178 | number N. */ | |
179 | #ifdef _INTL_REDIRECT_INLINE | |
180 | extern char *libintl_dngettext (const char *__domainname, const char *__msgid1, | |
181 | const char *__msgid2, unsigned long int __n); | |
182 | static inline char *dngettext (const char *__domainname, const char *__msgid1, | |
183 | const char *__msgid2, unsigned long int __n) | |
184 | { | |
185 | return libintl_dngettext (__domainname, __msgid1, __msgid2, __n); | |
186 | } | |
187 | #else | |
188 | #ifdef _INTL_REDIRECT_MACROS | |
189 | # define dngettext libintl_dngettext | |
190 | #endif | |
191 | extern char *dngettext (const char *__domainname, | |
192 | const char *__msgid1, const char *__msgid2, | |
193 | unsigned long int __n) | |
194 | _INTL_ASM (libintl_dngettext); | |
195 | #endif | |
196 | ||
197 | /* Similar to `dcgettext' but select the plural form corresponding to the | |
198 | number N. */ | |
199 | #ifdef _INTL_REDIRECT_INLINE | |
200 | extern char *libintl_dcngettext (const char *__domainname, | |
201 | const char *__msgid1, const char *__msgid2, | |
202 | unsigned long int __n, int __category); | |
203 | static inline char *dcngettext (const char *__domainname, | |
204 | const char *__msgid1, const char *__msgid2, | |
205 | unsigned long int __n, int __category) | |
206 | { | |
207 | return libintl_dcngettext (__domainname, __msgid1, __msgid2, __n, __category); | |
208 | } | |
209 | #else | |
210 | #ifdef _INTL_REDIRECT_MACROS | |
211 | # define dcngettext libintl_dcngettext | |
212 | #endif | |
213 | extern char *dcngettext (const char *__domainname, | |
214 | const char *__msgid1, const char *__msgid2, | |
215 | unsigned long int __n, int __category) | |
216 | _INTL_ASM (libintl_dcngettext); | |
217 | #endif | |
218 | ||
219 | ||
220 | /* Set the current default message catalog to DOMAINNAME. | |
221 | If DOMAINNAME is null, return the current default. | |
222 | If DOMAINNAME is "", reset to the default of "messages". */ | |
223 | #ifdef _INTL_REDIRECT_INLINE | |
224 | extern char *libintl_textdomain (const char *__domainname); | |
225 | static inline char *textdomain (const char *__domainname) | |
226 | { | |
227 | return libintl_textdomain (__domainname); | |
228 | } | |
229 | #else | |
230 | #ifdef _INTL_REDIRECT_MACROS | |
231 | # define textdomain libintl_textdomain | |
232 | #endif | |
233 | extern char *textdomain (const char *__domainname) | |
234 | _INTL_ASM (libintl_textdomain); | |
235 | #endif | |
236 | ||
237 | /* Specify that the DOMAINNAME message catalog will be found | |
238 | in DIRNAME rather than in the system locale data base. */ | |
239 | #ifdef _INTL_REDIRECT_INLINE | |
240 | extern char *libintl_bindtextdomain (const char *__domainname, | |
241 | const char *__dirname); | |
242 | static inline char *bindtextdomain (const char *__domainname, | |
243 | const char *__dirname) | |
244 | { | |
245 | return libintl_bindtextdomain (__domainname, __dirname); | |
246 | } | |
247 | #else | |
248 | #ifdef _INTL_REDIRECT_MACROS | |
249 | # define bindtextdomain libintl_bindtextdomain | |
250 | #endif | |
251 | extern char *bindtextdomain (const char *__domainname, const char *__dirname) | |
252 | _INTL_ASM (libintl_bindtextdomain); | |
253 | #endif | |
254 | ||
255 | /* Specify the character encoding in which the messages from the | |
256 | DOMAINNAME message catalog will be returned. */ | |
257 | #ifdef _INTL_REDIRECT_INLINE | |
258 | extern char *libintl_bind_textdomain_codeset (const char *__domainname, | |
259 | const char *__codeset); | |
260 | static inline char *bind_textdomain_codeset (const char *__domainname, | |
261 | const char *__codeset) | |
262 | { | |
263 | return libintl_bind_textdomain_codeset (__domainname, __codeset); | |
264 | } | |
265 | #else | |
266 | #ifdef _INTL_REDIRECT_MACROS | |
267 | # define bind_textdomain_codeset libintl_bind_textdomain_codeset | |
268 | #endif | |
269 | extern char *bind_textdomain_codeset (const char *__domainname, | |
270 | const char *__codeset) | |
271 | _INTL_ASM (libintl_bind_textdomain_codeset); | |
272 | #endif | |
273 | ||
274 | ||
275 | /* Support for format strings with positions in *printf(), following the | |
276 | POSIX/XSI specification. | |
277 | Note: These replacements for the *printf() functions are visible only | |
278 | in source files that #include <libintl.h> or #include "gettext.h". | |
279 | Packages that use *printf() in source files that don't refer to _() | |
280 | or gettext() but for which the format string could be the return value | |
281 | of _() or gettext() need to add this #include. Oh well. */ | |
282 | ||
283 | #if !@HAVE_POSIX_PRINTF@ | |
284 | ||
285 | #include <stdio.h> | |
286 | #include <stddef.h> | |
287 | ||
288 | /* Get va_list. */ | |
289 | #if __STDC__ || defined __cplusplus || defined _MSC_VER | |
290 | # include <stdarg.h> | |
291 | #else | |
292 | # include <varargs.h> | |
293 | #endif | |
294 | ||
295 | #undef fprintf | |
296 | #define fprintf libintl_fprintf | |
297 | extern int fprintf (FILE *, const char *, ...); | |
298 | #undef vfprintf | |
299 | #define vfprintf libintl_vfprintf | |
300 | extern int vfprintf (FILE *, const char *, va_list); | |
301 | ||
302 | #undef printf | |
303 | #define printf libintl_printf | |
304 | extern int printf (const char *, ...); | |
305 | #undef vprintf | |
306 | #define vprintf libintl_vprintf | |
307 | extern int vprintf (const char *, va_list); | |
308 | ||
309 | #undef sprintf | |
310 | #define sprintf libintl_sprintf | |
311 | extern int sprintf (char *, const char *, ...); | |
312 | #undef vsprintf | |
313 | #define vsprintf libintl_vsprintf | |
314 | extern int vsprintf (char *, const char *, va_list); | |
315 | ||
316 | #if @HAVE_SNPRINTF@ | |
317 | ||
318 | #undef snprintf | |
319 | #define snprintf libintl_snprintf | |
320 | extern int snprintf (char *, size_t, const char *, ...); | |
321 | #undef vsnprintf | |
322 | #define vsnprintf libintl_vsnprintf | |
323 | extern int vsnprintf (char *, size_t, const char *, va_list); | |
324 | ||
325 | #endif | |
326 | ||
327 | #if @HAVE_ASPRINTF@ | |
328 | ||
329 | #undef asprintf | |
330 | #define asprintf libintl_asprintf | |
331 | extern int asprintf (char **, const char *, ...); | |
332 | #undef vasprintf | |
333 | #define vasprintf libintl_vasprintf | |
334 | extern int vasprintf (char **, const char *, va_list); | |
335 | ||
336 | #endif | |
337 | ||
338 | #if @HAVE_WPRINTF@ | |
339 | ||
340 | #undef fwprintf | |
341 | #define fwprintf libintl_fwprintf | |
342 | extern int fwprintf (FILE *, const wchar_t *, ...); | |
343 | #undef vfwprintf | |
344 | #define vfwprintf libintl_vfwprintf | |
345 | extern int vfwprintf (FILE *, const wchar_t *, va_list); | |
346 | ||
347 | #undef wprintf | |
348 | #define wprintf libintl_wprintf | |
349 | extern int wprintf (const wchar_t *, ...); | |
350 | #undef vwprintf | |
351 | #define vwprintf libintl_vwprintf | |
352 | extern int vwprintf (const wchar_t *, va_list); | |
353 | ||
354 | #undef swprintf | |
355 | #define swprintf libintl_swprintf | |
356 | extern int swprintf (wchar_t *, size_t, const wchar_t *, ...); | |
357 | #undef vswprintf | |
358 | #define vswprintf libintl_vswprintf | |
359 | extern int vswprintf (wchar_t *, size_t, const wchar_t *, va_list); | |
360 | ||
361 | #endif | |
362 | ||
363 | #endif | |
364 | ||
365 | ||
366 | /* Support for relocatable packages. */ | |
367 | ||
368 | /* Sets the original and the current installation prefix of the package. | |
369 | Relocation simply replaces a pathname starting with the original prefix | |
370 | by the corresponding pathname with the current prefix instead. Both | |
371 | prefixes should be directory names without trailing slash (i.e. use "" | |
372 | instead of "/"). */ | |
373 | #define libintl_set_relocation_prefix libintl_set_relocation_prefix | |
374 | extern void | |
375 | libintl_set_relocation_prefix (const char *orig_prefix, | |
376 | const char *curr_prefix); | |
377 | ||
378 | ||
379 | #ifdef __cplusplus | |
380 | } | |
381 | #endif | |
382 | ||
383 | #endif /* libintl.h */ |