1 | /* Header describing internals of libintl library. |
2 | Copyright (C) 1995-2016 Free Software Foundation, Inc. |
3 | Written by Ulrich Drepper <drepper@cygnus.com>, 1995. |
4 | |
5 | This program is free software: you can redistribute it and/or modify |
6 | it under the terms of the GNU Lesser General Public License as published by |
7 | the Free Software Foundation; either version 2.1 of the License, or |
8 | (at your option) any later version. |
9 | |
10 | This program 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 |
13 | GNU Lesser General Public License for more details. |
14 | |
15 | You should have received a copy of the GNU Lesser General Public License |
16 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
17 | |
18 | #ifndef _GETTEXTP_H |
19 | #define _GETTEXTP_H |
20 | |
21 | #include <stddef.h> /* Get size_t. */ |
22 | |
23 | #ifdef _LIBC |
24 | # include "../iconv/gconv_int.h" |
25 | #else |
26 | # if HAVE_ICONV |
27 | # include <iconv.h> |
28 | # endif |
29 | #endif |
30 | |
31 | /* Handle multi-threaded applications. */ |
32 | #ifdef _LIBC |
33 | # include <libc-lock.h> |
34 | # define gl_rwlock_define __libc_rwlock_define |
35 | #else |
36 | # include "lock.h" |
37 | #endif |
38 | |
39 | #ifdef _LIBC |
40 | struct loaded_domain; |
41 | extern char *__gettext (const char *__msgid); |
42 | extern char *__dgettext (const char *__domainname, const char *__msgid); |
43 | extern char *__dcgettext (const char *__domainname, const char *__msgid, |
44 | int __category); |
45 | extern char *__ngettext (const char *__msgid1, const char *__msgid2, |
46 | unsigned long int __n); |
47 | extern char *__dngettext (const char *__domainname, |
48 | const char *__msgid1, const char *__msgid2, |
49 | unsigned long int n); |
50 | extern char *__dcngettext (const char *__domainname, |
51 | const char *__msgid1, const char *__msgid2, |
52 | unsigned long int __n, int __category); |
53 | extern char *__dcigettext (const char *__domainname, |
54 | const char *__msgid1, const char *__msgid2, |
55 | int __plural, unsigned long int __n, |
56 | int __category); |
57 | extern char *__textdomain (const char *__domainname); |
58 | extern char *__bindtextdomain (const char *__domainname, |
59 | const char *__dirname); |
60 | extern char *__bind_textdomain_codeset (const char *__domainname, |
61 | const char *__codeset); |
62 | extern void _nl_finddomain_subfreeres (void) attribute_hidden; |
63 | extern void _nl_unload_domain (struct loaded_domain *__domain) |
64 | internal_function attribute_hidden; |
65 | #else |
66 | /* Declare the exported libintl_* functions, in a way that allows us to |
67 | call them under their real name. */ |
68 | # undef _INTL_REDIRECT_INLINE |
69 | # undef _INTL_REDIRECT_MACROS |
70 | # define _INTL_REDIRECT_MACROS |
71 | # include "libgnuintl.h" |
72 | # ifdef IN_LIBGLOCALE |
73 | extern char *gl_dcigettext (const char *__domainname, |
74 | const char *__msgid1, const char *__msgid2, |
75 | int __plural, unsigned long int __n, |
76 | int __category, |
77 | const char *__localename, const char *__encoding); |
78 | # else |
79 | extern char *libintl_dcigettext (const char *__domainname, |
80 | const char *__msgid1, const char *__msgid2, |
81 | int __plural, unsigned long int __n, |
82 | int __category); |
83 | # endif |
84 | #endif |
85 | |
86 | #include "loadinfo.h" |
87 | |
88 | #include "gmo.h" /* Get nls_uint32. */ |
89 | |
90 | /* @@ end of prolog @@ */ |
91 | |
92 | #ifndef internal_function |
93 | # define internal_function |
94 | #endif |
95 | |
96 | #ifndef attribute_hidden |
97 | # define attribute_hidden |
98 | #endif |
99 | |
100 | /* Tell the compiler when a conditional or integer expression is |
101 | almost always true or almost always false. */ |
102 | #ifndef HAVE_BUILTIN_EXPECT |
103 | # define __builtin_expect(expr, val) (expr) |
104 | #endif |
105 | |
106 | #ifndef W |
107 | # define W(flag, data) ((flag) ? SWAP (data) : (data)) |
108 | #endif |
109 | |
110 | |
111 | #ifdef _LIBC |
112 | # include <byteswap.h> |
113 | # define SWAP(i) bswap_32 (i) |
114 | #else |
115 | static inline nls_uint32 |
116 | # ifdef __cplusplus |
117 | SWAP (nls_uint32 i) |
118 | # else |
119 | SWAP (i) |
120 | nls_uint32 i; |
121 | # endif |
122 | { |
123 | return (i << 24) | ((i & 0xff00) << 8) | ((i >> 8) & 0xff00) | (i >> 24); |
124 | } |
125 | #endif |
126 | |
127 | |
128 | /* In-memory representation of system dependent string. */ |
129 | struct sysdep_string_desc |
130 | { |
131 | /* Length of addressed string, including the trailing NUL. */ |
132 | size_t length; |
133 | /* Pointer to addressed string. */ |
134 | const char *pointer; |
135 | }; |
136 | |
137 | /* Cache of translated strings after charset conversion. |
138 | Note: The strings are converted to the target encoding only on an as-needed |
139 | basis. */ |
140 | struct converted_domain |
141 | { |
142 | /* The target encoding name. */ |
143 | const char *encoding; |
144 | /* The descriptor for conversion from the message catalog's encoding to |
145 | this target encoding. */ |
146 | #ifdef _LIBC |
147 | __gconv_t conv; |
148 | #else |
149 | # if HAVE_ICONV |
150 | iconv_t conv; |
151 | # endif |
152 | #endif |
153 | /* The table of translated strings after charset conversion. */ |
154 | char **conv_tab; |
155 | }; |
156 | |
157 | /* The representation of an opened message catalog. */ |
158 | struct loaded_domain |
159 | { |
160 | /* Pointer to memory containing the .mo file. */ |
161 | const char *data; |
162 | /* 1 if the memory is mmap()ed, 0 if the memory is malloc()ed. */ |
163 | int use_mmap; |
164 | /* Size of mmap()ed memory. */ |
165 | size_t mmap_size; |
166 | /* 1 if the .mo file uses a different endianness than this machine. */ |
167 | int must_swap; |
168 | /* Pointer to additional malloc()ed memory. */ |
169 | void *malloced; |
170 | |
171 | /* Number of static strings pairs. */ |
172 | nls_uint32 nstrings; |
173 | /* Pointer to descriptors of original strings in the file. */ |
174 | const struct string_desc *orig_tab; |
175 | /* Pointer to descriptors of translated strings in the file. */ |
176 | const struct string_desc *trans_tab; |
177 | |
178 | /* Number of system dependent strings pairs. */ |
179 | nls_uint32 n_sysdep_strings; |
180 | /* Pointer to descriptors of original sysdep strings. */ |
181 | const struct sysdep_string_desc *orig_sysdep_tab; |
182 | /* Pointer to descriptors of translated sysdep strings. */ |
183 | const struct sysdep_string_desc *trans_sysdep_tab; |
184 | |
185 | /* Size of hash table. */ |
186 | nls_uint32 hash_size; |
187 | /* Pointer to hash table. */ |
188 | const nls_uint32 *hash_tab; |
189 | /* 1 if the hash table uses a different endianness than this machine. */ |
190 | int must_swap_hash_tab; |
191 | |
192 | /* Cache of charset conversions of the translated strings. */ |
193 | struct converted_domain *conversions; |
194 | size_t nconversions; |
195 | gl_rwlock_define (, conversions_lock) |
196 | |
197 | const struct expression *plural; |
198 | unsigned long int nplurals; |
199 | }; |
200 | |
201 | /* We want to allocate a string at the end of the struct. But ISO C |
202 | doesn't allow zero sized arrays. */ |
203 | #ifdef __GNUC__ |
204 | # define ZERO 0 |
205 | #else |
206 | # define ZERO 1 |
207 | #endif |
208 | |
209 | /* A set of settings bound to a message domain. Used to store settings |
210 | from bindtextdomain() and bind_textdomain_codeset(). */ |
211 | struct binding |
212 | { |
213 | struct binding *next; |
214 | char *dirname; |
215 | char *codeset; |
216 | char domainname[ZERO]; |
217 | }; |
218 | |
219 | /* A counter which is incremented each time some previous translations |
220 | become invalid. |
221 | This variable is part of the external ABI of the GNU libintl. */ |
222 | #ifdef IN_LIBGLOCALE |
223 | # include <glocale/config.h> |
224 | extern LIBGLOCALE_DLL_EXPORTED int _nl_msg_cat_cntr; |
225 | #else |
226 | extern LIBINTL_DLL_EXPORTED int _nl_msg_cat_cntr; |
227 | #endif |
228 | |
229 | #ifndef _LIBC |
230 | extern const char *_nl_language_preferences_default (void); |
231 | # define gl_locale_name_canonicalize _nl_locale_name_canonicalize |
232 | extern void _nl_locale_name_canonicalize (char *name); |
233 | # define gl_locale_name_from_win32_LANGID _nl_locale_name_from_win32_LANGID |
234 | /* extern const char *_nl_locale_name_from_win32_LANGID (LANGID langid); */ |
235 | # define gl_locale_name_from_win32_LCID _nl_locale_name_from_win32_LCID |
236 | /* extern const char *_nl_locale_name_from_win32_LCID (LCID lcid); */ |
237 | # define gl_locale_name_thread_unsafe _nl_locale_name_thread_unsafe |
238 | extern const char *_nl_locale_name_thread_unsafe (int category, |
239 | const char *categoryname); |
240 | # define gl_locale_name_thread _nl_locale_name_thread |
241 | /* extern const char *_nl_locale_name_thread (int category, |
242 | const char *categoryname); */ |
243 | # define gl_locale_name_posix _nl_locale_name_posix |
244 | extern const char *_nl_locale_name_posix (int category, |
245 | const char *categoryname); |
246 | # define gl_locale_name_environ _nl_locale_name_environ |
247 | extern const char *_nl_locale_name_environ (int category, |
248 | const char *categoryname); |
249 | # define gl_locale_name_default _nl_locale_name_default |
250 | extern const char *_nl_locale_name_default (void); |
251 | # define gl_locale_name _nl_locale_name |
252 | /* extern const char *_nl_locale_name (int category, |
253 | const char *categoryname); */ |
254 | #endif |
255 | |
256 | struct loaded_l10nfile *_nl_find_domain (const char *__dirname, char *__locale, |
257 | const char *__domainname, |
258 | struct binding *__domainbinding) |
259 | internal_function; |
260 | void _nl_load_domain (struct loaded_l10nfile *__domain, |
261 | struct binding *__domainbinding) |
262 | internal_function; |
263 | |
264 | #ifdef IN_LIBGLOCALE |
265 | char *_nl_find_msg (struct loaded_l10nfile *domain_file, |
266 | struct binding *domainbinding, const char *encoding, |
267 | const char *msgid, |
268 | size_t *lengthp) |
269 | internal_function; |
270 | #else |
271 | char *_nl_find_msg (struct loaded_l10nfile *domain_file, |
272 | struct binding *domainbinding, const char *msgid, |
273 | int convert, size_t *lengthp) |
274 | internal_function; |
275 | #endif |
276 | |
277 | /* The internal variables in the standalone libintl.a must have different |
278 | names than the internal variables in GNU libc, otherwise programs |
279 | using libintl.a cannot be linked statically. */ |
280 | #if !defined _LIBC |
281 | # define _nl_default_dirname libintl_nl_default_dirname |
282 | # define _nl_domain_bindings libintl_nl_domain_bindings |
283 | #endif |
284 | |
285 | /* Contains the default location of the message catalogs. */ |
286 | extern const char _nl_default_dirname[]; |
287 | #ifdef _LIBC |
288 | libc_hidden_proto (_nl_default_dirname) |
289 | #endif |
290 | |
291 | /* List with bindings of specific domains. */ |
292 | extern struct binding *_nl_domain_bindings; |
293 | |
294 | /* The internal variables in the standalone libintl.a must have different |
295 | names than the internal variables in GNU libc, otherwise programs |
296 | using libintl.a cannot be linked statically. */ |
297 | #if !defined _LIBC |
298 | # define _nl_default_default_domain libintl_nl_default_default_domain |
299 | # define _nl_current_default_domain libintl_nl_current_default_domain |
300 | #endif |
301 | |
302 | /* Name of the default text domain. */ |
303 | extern const char _nl_default_default_domain[] attribute_hidden; |
304 | |
305 | /* Default text domain in which entries for gettext(3) are to be found. */ |
306 | extern const char *_nl_current_default_domain attribute_hidden; |
307 | |
308 | /* @@ begin of epilog @@ */ |
309 | |
310 | #endif /* gettextP.h */ |
311 | |