1 /* Declarations for internal libc locale interfaces
2 Copyright (C) 1995-2001, 2002 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library 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 GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, write to the Free
17 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
21 #define _LOCALEINFO_H 1
29 #include <sys/types.h>
31 #include <intl/loadinfo.h> /* For loaded_l10nfile definition. */
33 /* Magic number at the beginning of a locale data file for CATEGORY. */
34 #define LIMAGIC(category) ((unsigned int) (0x20000828 ^ (category)))
36 /* Two special weight constants for the collation data. */
39 /* We use a special value for the usage counter in `locale_data' to
40 signal that this data must never be removed anymore. */
41 #define MAX_USAGE_COUNT (UINT_MAX - 1)
42 #define UNDELETABLE UINT_MAX
44 /* Structure describing locale data in core for a category. */
48 const char *filedata
; /* Region mapping the file data. */
49 off_t filesize
; /* Size of the file (and the region). */
50 enum /* Flavor of storage used for those. */
52 ld_malloced
, /* Both are malloc'd. */
53 ld_mapped
, /* name is malloc'd, filedata mmap'd */
54 ld_archive
/* Both point into mmap'd archive regions. */
57 /* This provides a slot for category-specific code to cache data computed
58 about this locale. That code can set a cleanup function to deallocate
62 void (*cleanup
) (struct locale_data
*) internal_function
;
66 struct lc_time_data
*time
;
70 unsigned int usage_count
; /* Counter for users. */
72 int use_translit
; /* Nonzero if the mb*towv*() and wc*tomb()
73 functions should use transliteration. */
75 unsigned int nstrings
; /* Number of strings below. */
76 union locale_data_value
82 values __flexarr
; /* Items, usually pointers into `filedata'. */
85 /* We know three kinds of collation sorting rules. */
93 sort_forward_position
,
94 sort_backward_position
,
98 /* We can map the types of the entries into a few categories. */
115 /* Definitions for `era' information from LC_TIME. */
116 #define ERA_NAME_FORMAT_MEMBERS 4
118 #define ERA_M_FORMAT 1
120 #define ERA_W_FORMAT 3
123 /* Structure to access `era' information from LC_TIME. */
126 uint32_t direction
; /* Contains '+' or '-'. */
128 int32_t start_date
[3];
129 int32_t stop_date
[3];
130 const char *era_name
;
131 const char *era_format
;
132 const wchar_t *era_wname
;
133 const wchar_t *era_wformat
;
134 int absolute_direction
;
135 /* absolute direction:
136 +1 indicates that year number is higher in the future. (like A.D.)
137 -1 indicates that year number is higher in the past. (like B.C.) */
140 /* Structure caching computed data about information from LC_TIME.
141 The `private.time' member of `struct locale_data' points to this. */
144 struct era_entry
*eras
;
148 const char **alt_digits
;
149 const wchar_t **walt_digits
;
150 int alt_digits_initialized
, walt_digits_initialized
;
154 /* LC_CTYPE specific:
155 Hardwired indices for standard wide character translation mappings. */
163 /* LC_CTYPE specific:
164 Access a wide character class with a single character index.
165 _ISCTYPE (c, desc) = iswctype (btowc (c), desc).
166 c must be an `unsigned char'. desc must be a nonzero wctype_t. */
167 #define _ISCTYPE(c, desc) \
168 (((((const uint32_t *) (desc)) - 8)[(c) >> 5] >> ((c) & 0x1f)) & 1)
170 extern const char *const _nl_category_names
[__LC_LAST
] attribute_hidden
;
171 extern const size_t _nl_category_name_sizes
[__LC_LAST
] attribute_hidden
;
173 /* Name of the standard locales. */
174 extern const char _nl_C_name
[] attribute_hidden
;
175 extern const char _nl_POSIX_name
[] attribute_hidden
;
177 /* The standard codeset. */
178 extern const char _nl_C_codeset
[] attribute_hidden
;
180 /* This is the internal locale_t object that holds the global locale
181 controlled by calls to setlocale. A thread's TSD locale pointer
182 points to this when `uselocale (LC_GLOBAL_LOCALE)' is in effect. */
183 extern struct __locale_struct _nl_global_locale attribute_hidden
;
185 /* This fetches the thread-local locale_t pointer, either one set with
186 uselocale or &_nl_global_locale. */
187 #define _NL_CURRENT_LOCALE ((__locale_t) __libc_tsd_get (LOCALE))
188 #include <bits/libc-tsd.h>
189 __libc_tsd_define (extern, LOCALE
)
192 /* For static linking it is desireable to avoid always linking in the code
193 and data for every category when we can tell at link time that they are
194 unused. We can manage this playing some tricks with weak references.
195 But with thread-local locale settings, it becomes quite ungainly unless
196 we can use __thread variables. So only in that case do we attempt this. */
197 #if !defined SHARED && defined HAVE___THREAD && defined HAVE_WEAK_SYMBOLS
200 # define NL_CURRENT_INDIRECT 1
204 #ifdef NL_CURRENT_INDIRECT
206 /* For each category declare the thread-local variable for the current
207 locale data. This has an extra indirection so it points at the
208 __locales[CATEGORY] element in either _nl_global_locale or the current
209 locale object set by uselocale, which points at the actual data. The
210 reason for having these variables is so that references to particular
211 categories will link in the lc-CATEGORY.c module to define this symbol,
212 and we arrange that linking that module is what brings in all the code
213 associated with this category. */
214 #define DEFINE_CATEGORY(category, category_name, items, a) \
215 extern __thread struct locale_data *const *_nl_current_##category \
217 #include "categories.def"
218 #undef DEFINE_CATEGORY
220 /* Return a pointer to the current `struct locale_data' for CATEGORY. */
221 #define _NL_CURRENT_DATA(category) (*_nl_current_##category)
223 /* Extract the current CATEGORY locale's string for ITEM. */
224 #define _NL_CURRENT(category, item) \
225 ((*_nl_current_##category)->values[_NL_ITEM_INDEX (item)].string)
227 /* Extract the current CATEGORY locale's string for ITEM. */
228 #define _NL_CURRENT_WSTR(category, item) \
229 ((wchar_t *) (*_nl_current_##category)->values[_NL_ITEM_INDEX (item)].wstr)
231 /* Extract the current CATEGORY locale's word for ITEM. */
232 #define _NL_CURRENT_WORD(category, item) \
233 ((*_nl_current_##category)->values[_NL_ITEM_INDEX (item)].word)
235 /* This is used in lc-CATEGORY.c to define _nl_current_CATEGORY. */
236 #define _NL_CURRENT_DEFINE(category) \
237 __thread struct locale_data *const *_nl_current_##category \
238 attribute_hidden = &_nl_global_locale.__locales[category]; \
239 asm (_NL_CURRENT_DEFINE_STRINGIFY (ASM_GLOBAL_DIRECTIVE) \
240 " " __SYMBOL_PREFIX "_nl_current_" #category "_used\n" \
241 _NL_CURRENT_DEFINE_ABS (_nl_current_##category##_used, 1));
242 #define _NL_CURRENT_DEFINE_STRINGIFY(x) _NL_CURRENT_DEFINE_STRINGIFY_1 (x)
243 #define _NL_CURRENT_DEFINE_STRINGIFY_1(x) #x
244 #ifdef HAVE_ASM_SET_DIRECTIVE
245 # define _NL_CURRENT_DEFINE_ABS(sym, val) ".set " #sym ", " #val
247 # define _NL_CURRENT_DEFINE_ABS(sym, val) #sym " = " #val
252 /* All categories are always loaded in the shared library, so there is no
253 point in having lots of separate symbols for linking. */
255 /* Return a pointer to the current `struct locale_data' for CATEGORY. */
256 # define _NL_CURRENT_DATA(category) \
257 (_NL_CURRENT_LOCALE->__locales[category])
259 /* Extract the current CATEGORY locale's string for ITEM. */
260 # define _NL_CURRENT(category, item) \
261 (_NL_CURRENT_DATA (category)->values[_NL_ITEM_INDEX (item)].string)
263 /* Extract the current CATEGORY locale's string for ITEM. */
264 # define _NL_CURRENT_WSTR(category, item) \
265 ((wchar_t *) _NL_CURRENT_DATA (category)->values[_NL_ITEM_INDEX (item)].wstr)
267 /* Extract the current CATEGORY locale's word for ITEM. */
268 # define _NL_CURRENT_WORD(category, item) \
269 (_NL_CURRENT_DATA (category)->values[_NL_ITEM_INDEX (item)].word)
271 /* This is used in lc-CATEGORY.c to define _nl_current_CATEGORY. */
272 # define _NL_CURRENT_DEFINE(category) \
273 /* No per-category variable here. */
278 /* Default search path if no LOCPATH environment variable. */
279 extern const char _nl_default_locale_path
[] attribute_hidden
;
281 /* Load the locale data for CATEGORY from the file specified by *NAME.
282 If *NAME is "", use environment variables as specified by POSIX, and
283 fill in *NAME with the actual name used. If LOCALE_PATH is not null,
284 those directories are searched for the locale files. If it's null,
285 the locale archive is checked first and then _nl_default_locale_path
286 is searched for locale files. */
287 extern struct locale_data
*_nl_find_locale (const char *locale_path
,
288 size_t locale_path_len
,
289 int category
, const char **name
)
290 internal_function attribute_hidden
;
292 /* Try to load the file described by FILE. */
293 extern void _nl_load_locale (struct loaded_l10nfile
*file
, int category
)
294 internal_function attribute_hidden
;
296 /* Free all resource. */
297 extern void _nl_unload_locale (struct locale_data
*locale
)
298 internal_function attribute_hidden
;
300 /* Free the locale and give back all memory if the usage count is one. */
301 extern void _nl_remove_locale (int locale
, struct locale_data
*data
)
302 internal_function attribute_hidden
;
304 /* Find the locale *NAMEP in the locale archive, and return the
305 internalized data structure for its CATEGORY data. If this locale has
306 already been loaded from the archive, just returns the existing data
307 structure. If successful, sets *NAMEP to point directly into the mapped
308 archive string table; that way, the next call can short-circuit strcmp. */
309 extern struct locale_data
*_nl_load_locale_from_archive (int category
,
311 internal_function attribute_hidden
;
313 /* Subroutine of setlocale's __libc_subfreeres hook. */
314 extern void _nl_archive_subfreeres (void) attribute_hidden
;
316 /* Validate the contents of a locale file and set up the in-core
317 data structure to point into the data. This leaves the `alloc'
318 and `name' fields uninitialized, for the caller to fill in.
319 If any bogons are detected in the data, this will refuse to
320 intern it, and return a null pointer instead. */
321 extern struct locale_data
*_nl_intern_locale_data (int category
,
324 internal_function attribute_hidden
;
327 /* Return `era' entry which corresponds to TP. Used in strftime. */
328 extern struct era_entry
*_nl_get_era_entry (const struct tm
*tp
,
329 struct locale_data
*lc_time
)
330 internal_function attribute_hidden
;
332 /* Return `era' cnt'th entry . Used in strptime. */
333 extern struct era_entry
*_nl_select_era_entry (int cnt
,
334 struct locale_data
*lc_time
)
335 internal_function attribute_hidden
;
337 /* Return `alt_digit' which corresponds to NUMBER. Used in strftime. */
338 extern const char *_nl_get_alt_digit (unsigned int number
,
339 struct locale_data
*lc_time
)
340 internal_function attribute_hidden
;
342 /* Similar, but now for wide characters. */
343 extern const wchar_t *_nl_get_walt_digit (unsigned int number
,
344 struct locale_data
*lc_time
)
345 internal_function attribute_hidden
;
347 /* Parse string as alternative digit and return numeric value. */
348 extern int _nl_parse_alt_digit (const char **strp
,
349 struct locale_data
*lc_time
)
350 internal_function attribute_hidden
;
352 /* Postload processing. */
353 extern void _nl_postload_ctype (void);
355 /* Functions used for the `private.cleanup' hook. */
356 extern void _nl_cleanup_time (struct locale_data
*)
357 internal_function attribute_hidden
;
360 #endif /* localeinfo.h */