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.
4
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)
8   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 GNU
13   Library General Public License for more details.
14
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,
18   USA.  */
19
20#ifndef _LOADINFO_H
21#define _LOADINFO_H	1
22
23/* Declarations of locale dependent catalog lookup functions.
24   Implemented in
25
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.
30
31   The main function _nl_find_domain() in finddomain.c is declared
32   in gettextP.h.
33 */
34
35#ifndef PARAMS
36# if __STDC__ || defined __GNUC__ || defined __SUNPRO_C || defined __cplusplus || __PROTOTYPES
37#  define PARAMS(args) args
38# else
39#  define PARAMS(args) ()
40# endif
41#endif
42
43#ifndef internal_function
44# define internal_function
45#endif
46
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)
51#endif
52
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 ';'
57#else
58  /* Unix */
59# define PATH_SEPARATOR ':'
60#endif
61
62/* Encoding of locale name parts.  */
63#define CEN_REVISION		1
64#define CEN_SPONSOR		2
65#define CEN_SPECIAL		4
66#define XPG_NORM_CODESET	8
67#define XPG_CODESET		16
68#define TERRITORY		32
69#define CEN_AUDIENCE		64
70#define XPG_MODIFIER		128
71
72#define CEN_SPECIFIC	(CEN_REVISION|CEN_SPONSOR|CEN_SPECIAL|CEN_AUDIENCE)
73#define XPG_SPECIFIC	(XPG_CODESET|XPG_NORM_CODESET|XPG_MODIFIER)
74
75
76struct loaded_l10nfile
77{
78  const char *filename;
79  int decided;
80
81  const void *data;
82
83  struct loaded_l10nfile *next;
84  struct loaded_l10nfile *successor[1];
85};
86
87
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.  */
92extern const char *_nl_normalize_codeset PARAMS ((const char *codeset,
93						  size_t name_len));
94
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.  */
109extern 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,
113			    const char *codeset,
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));
118
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.  */
122extern const char *_nl_expand_alias PARAMS ((const char *name));
123
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
133   filled-in value:
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.
141 */
142extern 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));
150
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.  */
154extern char *_nl_find_language PARAMS ((const char *name));
155
156#endif	/* loadinfo.h */
157