1 |
269 |
jeremybenn |
/* 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., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301,
|
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 |
|
|
/* Use _INTL_PARAMS, not PARAMS, in order to avoid clashes with identifiers
|
51 |
|
|
used by programs. Similarly, test __PROTOTYPES, not PROTOTYPES. */
|
52 |
|
|
#ifndef _INTL_PARAMS
|
53 |
|
|
# if __STDC__ || defined __GNUC__ || defined __SUNPRO_C || defined __cplusplus || __PROTOTYPES
|
54 |
|
|
# define _INTL_PARAMS(args) args
|
55 |
|
|
# else
|
56 |
|
|
# define _INTL_PARAMS(args) ()
|
57 |
|
|
# endif
|
58 |
|
|
#endif
|
59 |
|
|
|
60 |
|
|
#ifdef __cplusplus
|
61 |
|
|
extern "C" {
|
62 |
|
|
#endif
|
63 |
|
|
|
64 |
|
|
|
65 |
|
|
/* We redirect the functions to those prefixed with "libintl_". This is
|
66 |
|
|
necessary, because some systems define gettext/textdomain/... in the C
|
67 |
|
|
library (namely, Solaris 2.4 and newer, and GNU libc 2.0 and newer).
|
68 |
|
|
If we used the unprefixed names, there would be cases where the
|
69 |
|
|
definition in the C library would override the one in the libintl.so
|
70 |
|
|
shared library. Recall that on ELF systems, the symbols are looked
|
71 |
|
|
up in the following order:
|
72 |
|
|
1. in the executable,
|
73 |
|
|
2. in the shared libraries specified on the link command line, in order,
|
74 |
|
|
3. in the dependencies of the shared libraries specified on the link
|
75 |
|
|
command line,
|
76 |
|
|
4. in the dlopen()ed shared libraries, in the order in which they were
|
77 |
|
|
dlopen()ed.
|
78 |
|
|
The definition in the C library would override the one in libintl.so if
|
79 |
|
|
either
|
80 |
|
|
* -lc is given on the link command line and -lintl isn't, or
|
81 |
|
|
* -lc is given on the link command line before -lintl, or
|
82 |
|
|
* libintl.so is a dependency of a dlopen()ed shared library but not
|
83 |
|
|
linked to the executable at link time.
|
84 |
|
|
Since Solaris gettext() behaves differently than GNU gettext(), this
|
85 |
|
|
would be unacceptable.
|
86 |
|
|
|
87 |
|
|
The redirection happens by default through macros in C, so that &gettext
|
88 |
|
|
is independent of the compilation unit, but through inline functions in
|
89 |
|
|
C++, in order not to interfere with the name mangling of class fields or
|
90 |
|
|
class methods called 'gettext'. */
|
91 |
|
|
|
92 |
|
|
/* The user can define _INTL_REDIRECT_INLINE or _INTL_REDIRECT_MACROS.
|
93 |
|
|
If he doesn't, we choose the method. A third possible method is
|
94 |
|
|
_INTL_REDIRECT_ASM, supported only by GCC. */
|
95 |
|
|
#if !(defined _INTL_REDIRECT_INLINE || defined _INTL_REDIRECT_MACROS)
|
96 |
|
|
# if __GNUC__ >= 2 && !defined __APPLE_CC__ && (defined __STDC__ || defined __cplusplus)
|
97 |
|
|
# define _INTL_REDIRECT_ASM
|
98 |
|
|
# else
|
99 |
|
|
# ifdef __cplusplus
|
100 |
|
|
# define _INTL_REDIRECT_INLINE
|
101 |
|
|
# else
|
102 |
|
|
# define _INTL_REDIRECT_MACROS
|
103 |
|
|
# endif
|
104 |
|
|
# endif
|
105 |
|
|
#endif
|
106 |
|
|
/* Auxiliary macros. */
|
107 |
|
|
#ifdef _INTL_REDIRECT_ASM
|
108 |
|
|
# define _INTL_ASM(cname) __asm__ (_INTL_ASMNAME (__USER_LABEL_PREFIX__, #cname))
|
109 |
|
|
# define _INTL_ASMNAME(prefix,cnamestring) _INTL_STRINGIFY (prefix) cnamestring
|
110 |
|
|
# define _INTL_STRINGIFY(prefix) #prefix
|
111 |
|
|
#else
|
112 |
|
|
# define _INTL_ASM(cname)
|
113 |
|
|
#endif
|
114 |
|
|
|
115 |
|
|
/* _INTL_MAY_RETURN_STRING_ARG(n) declares that the given function may return
|
116 |
|
|
its n-th argument literally. This enables GCC to warn for example about
|
117 |
|
|
printf (gettext ("foo %y")). */
|
118 |
|
|
#if __GNUC__ >= 3 && !(__APPLE_CC__ > 1 && defined __cplusplus)
|
119 |
|
|
# define _INTL_MAY_RETURN_STRING_ARG(n) __attribute__ ((__format_arg__ (n)))
|
120 |
|
|
#else
|
121 |
|
|
# define _INTL_MAY_RETURN_STRING_ARG(n)
|
122 |
|
|
#endif
|
123 |
|
|
|
124 |
|
|
/* Look up MSGID in the current default message catalog for the current
|
125 |
|
|
LC_MESSAGES locale. If not found, returns MSGID itself (the default
|
126 |
|
|
text). */
|
127 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
128 |
|
|
extern char *libintl_gettext (const char *__msgid)
|
129 |
|
|
_INTL_MAY_RETURN_STRING_ARG (1);
|
130 |
|
|
static inline char *gettext (const char *__msgid)
|
131 |
|
|
{
|
132 |
|
|
return libintl_gettext (__msgid);
|
133 |
|
|
}
|
134 |
|
|
#else
|
135 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
136 |
|
|
# define gettext libintl_gettext
|
137 |
|
|
#endif
|
138 |
|
|
extern char *gettext _INTL_PARAMS ((const char *__msgid))
|
139 |
|
|
_INTL_ASM (libintl_gettext)
|
140 |
|
|
_INTL_MAY_RETURN_STRING_ARG (1);
|
141 |
|
|
#endif
|
142 |
|
|
|
143 |
|
|
/* Look up MSGID in the DOMAINNAME message catalog for the current
|
144 |
|
|
LC_MESSAGES locale. */
|
145 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
146 |
|
|
extern char *libintl_dgettext (const char *__domainname, const char *__msgid)
|
147 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2);
|
148 |
|
|
static inline char *dgettext (const char *__domainname, const char *__msgid)
|
149 |
|
|
{
|
150 |
|
|
return libintl_dgettext (__domainname, __msgid);
|
151 |
|
|
}
|
152 |
|
|
#else
|
153 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
154 |
|
|
# define dgettext libintl_dgettext
|
155 |
|
|
#endif
|
156 |
|
|
extern char *dgettext _INTL_PARAMS ((const char *__domainname,
|
157 |
|
|
const char *__msgid))
|
158 |
|
|
_INTL_ASM (libintl_dgettext)
|
159 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2);
|
160 |
|
|
#endif
|
161 |
|
|
|
162 |
|
|
/* Look up MSGID in the DOMAINNAME message catalog for the current CATEGORY
|
163 |
|
|
locale. */
|
164 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
165 |
|
|
extern char *libintl_dcgettext (const char *__domainname, const char *__msgid,
|
166 |
|
|
int __category)
|
167 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2);
|
168 |
|
|
static inline char *dcgettext (const char *__domainname, const char *__msgid,
|
169 |
|
|
int __category)
|
170 |
|
|
{
|
171 |
|
|
return libintl_dcgettext (__domainname, __msgid, __category);
|
172 |
|
|
}
|
173 |
|
|
#else
|
174 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
175 |
|
|
# define dcgettext libintl_dcgettext
|
176 |
|
|
#endif
|
177 |
|
|
extern char *dcgettext _INTL_PARAMS ((const char *__domainname,
|
178 |
|
|
const char *__msgid,
|
179 |
|
|
int __category))
|
180 |
|
|
_INTL_ASM (libintl_dcgettext)
|
181 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2);
|
182 |
|
|
#endif
|
183 |
|
|
|
184 |
|
|
|
185 |
|
|
/* Similar to `gettext' but select the plural form corresponding to the
|
186 |
|
|
number N. */
|
187 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
188 |
|
|
extern char *libintl_ngettext (const char *__msgid1, const char *__msgid2,
|
189 |
|
|
unsigned long int __n)
|
190 |
|
|
_INTL_MAY_RETURN_STRING_ARG (1) _INTL_MAY_RETURN_STRING_ARG (2);
|
191 |
|
|
static inline char *ngettext (const char *__msgid1, const char *__msgid2,
|
192 |
|
|
unsigned long int __n)
|
193 |
|
|
{
|
194 |
|
|
return libintl_ngettext (__msgid1, __msgid2, __n);
|
195 |
|
|
}
|
196 |
|
|
#else
|
197 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
198 |
|
|
# define ngettext libintl_ngettext
|
199 |
|
|
#endif
|
200 |
|
|
extern char *ngettext _INTL_PARAMS ((const char *__msgid1,
|
201 |
|
|
const char *__msgid2,
|
202 |
|
|
unsigned long int __n))
|
203 |
|
|
_INTL_ASM (libintl_ngettext)
|
204 |
|
|
_INTL_MAY_RETURN_STRING_ARG (1) _INTL_MAY_RETURN_STRING_ARG (2);
|
205 |
|
|
#endif
|
206 |
|
|
|
207 |
|
|
/* Similar to `dgettext' but select the plural form corresponding to the
|
208 |
|
|
number N. */
|
209 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
210 |
|
|
extern char *libintl_dngettext (const char *__domainname, const char *__msgid1,
|
211 |
|
|
const char *__msgid2, unsigned long int __n)
|
212 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2) _INTL_MAY_RETURN_STRING_ARG (3);
|
213 |
|
|
static inline char *dngettext (const char *__domainname, const char *__msgid1,
|
214 |
|
|
const char *__msgid2, unsigned long int __n)
|
215 |
|
|
{
|
216 |
|
|
return libintl_dngettext (__domainname, __msgid1, __msgid2, __n);
|
217 |
|
|
}
|
218 |
|
|
#else
|
219 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
220 |
|
|
# define dngettext libintl_dngettext
|
221 |
|
|
#endif
|
222 |
|
|
extern char *dngettext _INTL_PARAMS ((const char *__domainname,
|
223 |
|
|
const char *__msgid1,
|
224 |
|
|
const char *__msgid2,
|
225 |
|
|
unsigned long int __n))
|
226 |
|
|
_INTL_ASM (libintl_dngettext)
|
227 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2) _INTL_MAY_RETURN_STRING_ARG (3);
|
228 |
|
|
#endif
|
229 |
|
|
|
230 |
|
|
/* Similar to `dcgettext' but select the plural form corresponding to the
|
231 |
|
|
number N. */
|
232 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
233 |
|
|
extern char *libintl_dcngettext (const char *__domainname,
|
234 |
|
|
const char *__msgid1, const char *__msgid2,
|
235 |
|
|
unsigned long int __n, int __category)
|
236 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2) _INTL_MAY_RETURN_STRING_ARG (3);
|
237 |
|
|
static inline char *dcngettext (const char *__domainname,
|
238 |
|
|
const char *__msgid1, const char *__msgid2,
|
239 |
|
|
unsigned long int __n, int __category)
|
240 |
|
|
{
|
241 |
|
|
return libintl_dcngettext (__domainname, __msgid1, __msgid2, __n, __category);
|
242 |
|
|
}
|
243 |
|
|
#else
|
244 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
245 |
|
|
# define dcngettext libintl_dcngettext
|
246 |
|
|
#endif
|
247 |
|
|
extern char *dcngettext _INTL_PARAMS ((const char *__domainname,
|
248 |
|
|
const char *__msgid1,
|
249 |
|
|
const char *__msgid2,
|
250 |
|
|
unsigned long int __n,
|
251 |
|
|
int __category))
|
252 |
|
|
_INTL_ASM (libintl_dcngettext)
|
253 |
|
|
_INTL_MAY_RETURN_STRING_ARG (2) _INTL_MAY_RETURN_STRING_ARG (3);
|
254 |
|
|
#endif
|
255 |
|
|
|
256 |
|
|
|
257 |
|
|
/* Set the current default message catalog to DOMAINNAME.
|
258 |
|
|
If DOMAINNAME is null, return the current default.
|
259 |
|
|
If DOMAINNAME is "", reset to the default of "messages". */
|
260 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
261 |
|
|
extern char *libintl_textdomain (const char *__domainname);
|
262 |
|
|
static inline char *textdomain (const char *__domainname)
|
263 |
|
|
{
|
264 |
|
|
return libintl_textdomain (__domainname);
|
265 |
|
|
}
|
266 |
|
|
#else
|
267 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
268 |
|
|
# define textdomain libintl_textdomain
|
269 |
|
|
#endif
|
270 |
|
|
extern char *textdomain _INTL_PARAMS ((const char *__domainname))
|
271 |
|
|
_INTL_ASM (libintl_textdomain);
|
272 |
|
|
#endif
|
273 |
|
|
|
274 |
|
|
/* Specify that the DOMAINNAME message catalog will be found
|
275 |
|
|
in DIRNAME rather than in the system locale data base. */
|
276 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
277 |
|
|
extern char *libintl_bindtextdomain (const char *__domainname,
|
278 |
|
|
const char *__dirname);
|
279 |
|
|
static inline char *bindtextdomain (const char *__domainname,
|
280 |
|
|
const char *__dirname)
|
281 |
|
|
{
|
282 |
|
|
return libintl_bindtextdomain (__domainname, __dirname);
|
283 |
|
|
}
|
284 |
|
|
#else
|
285 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
286 |
|
|
# define bindtextdomain libintl_bindtextdomain
|
287 |
|
|
#endif
|
288 |
|
|
extern char *bindtextdomain _INTL_PARAMS ((const char *__domainname,
|
289 |
|
|
const char *__dirname))
|
290 |
|
|
_INTL_ASM (libintl_bindtextdomain);
|
291 |
|
|
#endif
|
292 |
|
|
|
293 |
|
|
/* Specify the character encoding in which the messages from the
|
294 |
|
|
DOMAINNAME message catalog will be returned. */
|
295 |
|
|
#ifdef _INTL_REDIRECT_INLINE
|
296 |
|
|
extern char *libintl_bind_textdomain_codeset (const char *__domainname,
|
297 |
|
|
const char *__codeset);
|
298 |
|
|
static inline char *bind_textdomain_codeset (const char *__domainname,
|
299 |
|
|
const char *__codeset)
|
300 |
|
|
{
|
301 |
|
|
return libintl_bind_textdomain_codeset (__domainname, __codeset);
|
302 |
|
|
}
|
303 |
|
|
#else
|
304 |
|
|
#ifdef _INTL_REDIRECT_MACROS
|
305 |
|
|
# define bind_textdomain_codeset libintl_bind_textdomain_codeset
|
306 |
|
|
#endif
|
307 |
|
|
extern char *bind_textdomain_codeset _INTL_PARAMS ((const char *__domainname,
|
308 |
|
|
const char *__codeset))
|
309 |
|
|
_INTL_ASM (libintl_bind_textdomain_codeset);
|
310 |
|
|
#endif
|
311 |
|
|
|
312 |
|
|
|
313 |
|
|
/* Support for relocatable packages. */
|
314 |
|
|
|
315 |
|
|
/* Sets the original and the current installation prefix of the package.
|
316 |
|
|
Relocation simply replaces a pathname starting with the original prefix
|
317 |
|
|
by the corresponding pathname with the current prefix instead. Both
|
318 |
|
|
prefixes should be directory names without trailing slash (i.e. use ""
|
319 |
|
|
instead of "/"). */
|
320 |
|
|
#define libintl_set_relocation_prefix libintl_set_relocation_prefix
|
321 |
|
|
extern void
|
322 |
|
|
libintl_set_relocation_prefix _INTL_PARAMS ((const char *orig_prefix,
|
323 |
|
|
const char *curr_prefix));
|
324 |
|
|
|
325 |
|
|
|
326 |
|
|
#ifdef __cplusplus
|
327 |
|
|
}
|
328 |
|
|
#endif
|
329 |
|
|
|
330 |
|
|
#endif /* libintl.h */
|