1
/* Copyright (C) 1996-1999, 2000-2002 Free Software Foundation, Inc.
2
This file is part of the GNU C Library.
3
Contributed by Ulrich Drepper <drepper@cygnus.com>, 1996.
5
This program is free software; you can redistribute it and/or modify it
6
under the terms of the GNU Library General Public License as published
7
by the Free Software Foundation; either version 2, or (at your option)
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 GNU
13
Library General Public License for more details.
15
You should have received a copy of the GNU Library General Public
16
License along with this program; if not, write to the Free Software
17
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
23
/* Declarations of locale dependent catalog lookup functions.
26
localealias.c Possibly replace a locale name by another.
27
explodename.c Split a locale name into its various fields.
28
l10nflist.c Generate a list of filenames of possible message catalogs.
29
finddomain.c Find and open the relevant message catalogs.
31
The main function _nl_find_domain() in finddomain.c is declared
36
# if __STDC__ || defined __GNUC__ || defined __SUNPRO_C || defined __cplusplus || __PROTOTYPES
37
# define PARAMS(args) args
39
# define PARAMS(args) ()
43
#ifndef internal_function
44
# define internal_function
47
/* Tell the compiler when a conditional or integer expression is
48
almost always true or almost always false. */
49
#ifndef HAVE_BUILTIN_EXPECT
50
# define __builtin_expect(expr, val) (expr)
53
/* Separator in PATH like lists of pathnames. */
54
#if defined _WIN32 || defined __WIN32__ || defined __EMX__ || defined __DJGPP__
55
/* Win32, OS/2, DOS */
56
# define PATH_SEPARATOR ';'
59
# define PATH_SEPARATOR ':'
62
/* Encoding of locale name parts. */
63
#define CEN_REVISION 1
66
#define XPG_NORM_CODESET 8
67
#define XPG_CODESET 16
69
#define CEN_AUDIENCE 64
70
#define XPG_MODIFIER 128
72
#define CEN_SPECIFIC (CEN_REVISION|CEN_SPONSOR|CEN_SPECIAL|CEN_AUDIENCE)
73
#define XPG_SPECIFIC (XPG_CODESET|XPG_NORM_CODESET|XPG_MODIFIER)
76
struct loaded_l10nfile
83
struct loaded_l10nfile *next;
84
struct loaded_l10nfile *successor[1];
88
/* Normalize codeset name. There is no standard for the codeset
89
names. Normalization allows the user to use any of the common
90
names. The return value is dynamically allocated and has to be
91
freed by the caller. */
92
extern const char *_nl_normalize_codeset PARAMS ((const char *codeset,
95
/* Lookup a locale dependent file.
96
*L10NFILE_LIST denotes a pool of lookup results of locale dependent
97
files of the same kind, sorted in decreasing order of ->filename.
98
DIRLIST and DIRLIST_LEN are an argz list of directories in which to
99
look, containing at least one directory (i.e. DIRLIST_LEN > 0).
100
MASK, LANGUAGE, TERRITORY, CODESET, NORMALIZED_CODESET, MODIFIER,
101
SPECIAL, SPONSOR, REVISION are the pieces of the locale name, as
102
produced by _nl_explode_name(). FILENAME is the filename suffix.
103
The return value is the lookup result, either found in *L10NFILE_LIST,
104
or - if DO_ALLOCATE is nonzero - freshly allocated, or possibly NULL.
105
If the return value is non-NULL, it is added to *L10NFILE_LIST, and
106
its ->next field denotes the chaining inside *L10NFILE_LIST, and
107
furthermore its ->successor[] field contains a list of other lookup
108
results from which this lookup result inherits. */
109
extern struct loaded_l10nfile *
110
_nl_make_l10nflist PARAMS ((struct loaded_l10nfile **l10nfile_list,
111
const char *dirlist, size_t dirlist_len, int mask,
112
const char *language, const char *territory,
114
const char *normalized_codeset,
115
const char *modifier, const char *special,
116
const char *sponsor, const char *revision,
117
const char *filename, int do_allocate));
119
/* Lookup the real locale name for a locale alias NAME, or NULL if
120
NAME is not a locale alias (but possibly a real locale name).
121
The return value is statically allocated and must not be freed. */
122
extern const char *_nl_expand_alias PARAMS ((const char *name));
124
/* Split a locale name NAME into its pieces: language, modifier,
125
territory, codeset, special, sponsor, revision.
126
NAME gets destructively modified: NUL bytes are inserted here and
127
there. *LANGUAGE gets assigned NAME. Each of *MODIFIER, *TERRITORY,
128
*CODESET, *SPECIAL, *SPONSOR, *REVISION gets assigned either a
129
pointer into the old NAME string, or NULL. *NORMALIZED_CODESET
130
gets assigned the expanded *CODESET, if it is different from *CODESET;
131
this one is dynamically allocated and has to be freed by the caller.
132
The return value is a bitmask, where each bit corresponds to one
134
XPG_MODIFIER, CEN_AUDIENCE for *MODIFIER,
135
TERRITORY for *TERRITORY,
136
XPG_CODESET for *CODESET,
137
XPG_NORM_CODESET for *NORMALIZED_CODESET,
138
CEN_SPECIAL for *SPECIAL,
139
CEN_SPONSOR for *SPONSOR,
140
CEN_REVISION for *REVISION.
142
extern int _nl_explode_name PARAMS ((char *name, const char **language,
143
const char **modifier,
144
const char **territory,
145
const char **codeset,
146
const char **normalized_codeset,
147
const char **special,
148
const char **sponsor,
149
const char **revision));
151
/* Split a locale name NAME into a leading language part and all the
152
rest. Return a pointer to the first character after the language,
153
i.e. to the first byte of the rest. */
154
extern char *_nl_find_language PARAMS ((const char *name));
156
#endif /* loadinfo.h */