[deliverable/binutils-gdb.git] / intl / loadinfo.h

/* Copyright (C) 1996-1999, 2000-2002 Free Software Foundation, Inc.
   This file is part of the GNU C Library.
   Contributed by Ulrich Drepper <drepper@cygnus.com>, 1996.

   This program is free software; you can redistribute it and/or modify it
   under the terms of the GNU Library General Public License as published
   by the Free Software Foundation; either version 2, or (at your option)
   any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301,
   USA.  */

#ifndef _LOADINFO_H
#define _LOADINFO_H	1

/* Declarations of locale dependent catalog lookup functions.
   Implemented in

     localealias.c    Possibly replace a locale name by another.
     explodename.c    Split a locale name into its various fields.
     l10nflist.c      Generate a list of filenames of possible message catalogs.
     finddomain.c     Find and open the relevant message catalogs.

   The main function _nl_find_domain() in finddomain.c is declared
   in gettextP.h.
 */

#ifndef PARAMS
# if __STDC__ || defined __GNUC__ || defined __SUNPRO_C || defined __cplusplus || __PROTOTYPES
#  define PARAMS(args) args
# else
#  define PARAMS(args) ()
# endif
#endif

#ifndef internal_function
# define internal_function
#endif

/* Tell the compiler when a conditional or integer expression is
   almost always true or almost always false.  */
#ifndef HAVE_BUILTIN_EXPECT
# define __builtin_expect(expr, val) (expr)
#endif

/* Separator in PATH like lists of pathnames.  */
#if defined _WIN32 || defined __WIN32__ || defined __EMX__ || defined __DJGPP__
  /* Win32, OS/2, DOS */
# define PATH_SEPARATOR ';'
#else
  /* Unix */
# define PATH_SEPARATOR ':'
#endif

/* Encoding of locale name parts.  */
#define CEN_REVISION		1
#define CEN_SPONSOR		2
#define CEN_SPECIAL		4
#define XPG_NORM_CODESET	8
#define XPG_CODESET		16
#define TERRITORY		32
#define CEN_AUDIENCE		64
#define XPG_MODIFIER		128

#define CEN_SPECIFIC	(CEN_REVISION|CEN_SPONSOR|CEN_SPECIAL|CEN_AUDIENCE)
#define XPG_SPECIFIC	(XPG_CODESET|XPG_NORM_CODESET|XPG_MODIFIER)


struct loaded_l10nfile
{
  const char *filename;
  int decided;

  const void *data;

  struct loaded_l10nfile *next;
  struct loaded_l10nfile *successor[1];
};


/* Normalize codeset name.  There is no standard for the codeset
   names.  Normalization allows the user to use any of the common
   names.  The return value is dynamically allocated and has to be
   freed by the caller.  */
extern const char *_nl_normalize_codeset PARAMS ((const char *codeset,
						  size_t name_len));

/* Lookup a locale dependent file.
   *L10NFILE_LIST denotes a pool of lookup results of locale dependent
   files of the same kind, sorted in decreasing order of ->filename.
   DIRLIST and DIRLIST_LEN are an argz list of directories in which to
   look, containing at least one directory (i.e. DIRLIST_LEN > 0).
   MASK, LANGUAGE, TERRITORY, CODESET, NORMALIZED_CODESET, MODIFIER,
   SPECIAL, SPONSOR, REVISION are the pieces of the locale name, as
   produced by _nl_explode_name().  FILENAME is the filename suffix.
   The return value is the lookup result, either found in *L10NFILE_LIST,
   or - if DO_ALLOCATE is nonzero - freshly allocated, or possibly NULL.
   If the return value is non-NULL, it is added to *L10NFILE_LIST, and
   its ->next field denotes the chaining inside *L10NFILE_LIST, and
   furthermore its ->successor[] field contains a list of other lookup
   results from which this lookup result inherits.  */
extern struct loaded_l10nfile *
_nl_make_l10nflist PARAMS ((struct loaded_l10nfile **l10nfile_list,
			    const char *dirlist, size_t dirlist_len, int mask,
			    const char *language, const char *territory,
			    const char *codeset,
			    const char *normalized_codeset,
			    const char *modifier, const char *special,
			    const char *sponsor, const char *revision,
			    const char *filename, int do_allocate));

/* Lookup the real locale name for a locale alias NAME, or NULL if
   NAME is not a locale alias (but possibly a real locale name).
   The return value is statically allocated and must not be freed.  */
extern const char *_nl_expand_alias PARAMS ((const char *name));

/* Split a locale name NAME into its pieces: language, modifier,
   territory, codeset, special, sponsor, revision.
   NAME gets destructively modified: NUL bytes are inserted here and
   there.  *LANGUAGE gets assigned NAME.  Each of *MODIFIER, *TERRITORY,
   *CODESET, *SPECIAL, *SPONSOR, *REVISION gets assigned either a
   pointer into the old NAME string, or NULL.  *NORMALIZED_CODESET
   gets assigned the expanded *CODESET, if it is different from *CODESET;
   this one is dynamically allocated and has to be freed by the caller.
   The return value is a bitmask, where each bit corresponds to one
   filled-in value:
     XPG_MODIFIER, CEN_AUDIENCE  for *MODIFIER,
     TERRITORY                   for *TERRITORY,
     XPG_CODESET                 for *CODESET,
     XPG_NORM_CODESET            for *NORMALIZED_CODESET,
     CEN_SPECIAL                 for *SPECIAL,
     CEN_SPONSOR                 for *SPONSOR,
     CEN_REVISION                for *REVISION.
 */
extern int _nl_explode_name PARAMS ((char *name, const char **language,
				     const char **modifier,
				     const char **territory,
				     const char **codeset,
				     const char **normalized_codeset,
				     const char **special,
				     const char **sponsor,
				     const char **revision));

/* Split a locale name NAME into a leading language part and all the
   rest.  Return a pointer to the first character after the language,
   i.e. to the first byte of the rest.  */
extern char *_nl_find_language PARAMS ((const char *name));

#endif	/* loadinfo.h */
Commit	Line	Data
bf070c84	1	/* Copyright (C) 1996-1999, 2000-2002 Free Software Foundation, Inc.
1491f078 BE	2	This file is part of the GNU C Library.
	3	Contributed by Ulrich Drepper <drepper@cygnus.com>, 1996.
	4
bf070c84 SE	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)
1491f078 BE	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
bf070c84 SE	12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
bf070c84 SE	13	Library General Public License for more details.
1491f078	14
bf070c84 SE	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., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301,
	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	*/
1491f078	34
252b5132	35	#ifndef PARAMS
bf070c84	36	# if __STDC__ \|\| defined __GNUC__ \|\| defined __SUNPRO_C \|\| defined __cplusplus \|\| __PROTOTYPES
252b5132 RH	37	# define PARAMS(args) args
	38	# else
	39	# define PARAMS(args) ()
	40	# endif
	41	#endif
	42
bf070c84 SE	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
252b5132 RH	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
	76	struct 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
bf070c84 SE	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,
252b5132 RH	93	size_t name_len));
252b5132 RH	94
bf070c84 SE	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. */
252b5132 RH	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,
	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
bf070c84 SE	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. */
252b5132 RH	122	extern const char _nl_expand_alias PARAMS ((const char name));
252b5132 RH	123
bf070c84 SE	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	*/
252b5132 RH	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));
bf070c84 SE	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. */
	154	extern char _nl_find_language PARAMS ((const char name));
	155
	156	#endif /* loadinfo.h */