intl/libgettext.h

   1 /* Message catalogs for internationalization.
   2    Copyright (C) 1995, 1996, 1997, 1998 Free Software Foundation, Inc.
   3
   4    This program is free software; you can redistribute it and/or modify
   5    it under the terms of the GNU General Public License as published by
   6    the Free Software Foundation; either version 2, or (at your option)
   7    any later version.
   8
   9    This program is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12    GNU General Public License for more details.
  13
  14    You should have received a copy of the GNU General Public License
  15    along with this program; if not, write to the Free Software Foundation,
  16    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
  17
  18 /* Because on some systems (e.g. Solaris) we sometimes have to include
  19    the systems libintl.h as well as this file we have more complex
  20    include protection above.  But the systems header might perhaps also
  21    define _LIBINTL_H and therefore we have to protect the definition here.  */
  22
  23 #if !defined _LIBINTL_H || !defined _LIBGETTEXT_H
  24 #ifndef _LIBINTL_H
  25 # define _LIBINTL_H     1
  26 #endif
  27 #define _LIBGETTEXT_H   1
  28
  29 /* We define an additional symbol to signal that we use the GNU
  30    implementation of gettext.  */
  31 #define __USE_GNU_GETTEXT 1
  32
  33 #include <sys/types.h>
  34
  35 #if HAVE_LOCALE_H
  36 # include <locale.h>
  37 #endif
  38
  39
  40 #ifdef __cplusplus
  41 extern "C" {
  42 #endif
  43
  44 /* @@ end of prolog @@ */
  45
  46 #ifndef PARAMS
  47 # if __STDC__ || defined __cplusplus
  48 #  define PARAMS(args) args
  49 # else
  50 #  define PARAMS(args) ()
  51 # endif
  52 #endif
  53
  54 #ifndef NULL
  55 # if !defined __cplusplus || defined __GNUC__
  56 #  define NULL ((void *) 0)
  57 # else
  58 #  define NULL (0)
  59 # endif
  60 #endif
  61
  62 #if !HAVE_LC_MESSAGES
  63 /* This value determines the behaviour of the gettext() and dgettext()
  64    function.  But some system does not have this defined.  Define it
  65    to a default value.  */
  66 # define LC_MESSAGES (-1)
  67 #endif
  68
  69
  70 /* Declarations for gettext-using-catgets interface.  Derived from
  71    Jim Meyering's libintl.h.  */
  72 struct _msg_ent
  73 {
  74   const char *_msg;
  75   int _msg_number;
  76 };
  77
  78
  79 #if HAVE_CATGETS
  80 /* These two variables are defined in the automatically by po-to-tbl.sed
  81    generated file `cat-id-tbl.c'.  */
  82 extern const struct _msg_ent _msg_tbl[];
  83 extern int _msg_tbl_length;
  84 #endif
  85
  86
  87 /* For automatical extraction of messages sometimes no real
  88    translation is needed.  Instead the string itself is the result.
  89    Do not parenthesize Str in the definiens,
  90    as that breaks string literal concatenation.  */
  91 #define gettext_noop(Str) Str
  92
  93 /* Look up MSGID in the current default message catalog for the current
  94    LC_MESSAGES locale.  If not found, returns MSGID itself (the default
  95    text).  */
  96 extern char *gettext PARAMS ((const char *__msgid));
  97 extern char *gettext__ PARAMS ((const char *__msgid));
  98
  99 /* Look up MSGID in the DOMAINNAME message catalog for the current
 100    LC_MESSAGES locale.  */
 101 extern char *dgettext PARAMS ((const char *__domainname, const char *__msgid));
 102 extern char *dgettext__ PARAMS ((const char *__domainname,
 103                                  const char *__msgid));
 104
 105 /* Look up MSGID in the DOMAINNAME message catalog for the current CATEGORY
 106    locale.  */
 107 extern char *dcgettext PARAMS ((const char *__domainname, const char *__msgid,
 108                                 int __category));
 109 extern char *dcgettext__ PARAMS ((const char *__domainname,
 110                                   const char *__msgid, int __category));
 111
 112
 113 /* Set the current default message catalog to DOMAINNAME.
 114    If DOMAINNAME is null, return the current default.
 115    If DOMAINNAME is "", reset to the default of "messages".  */
 116 extern char *textdomain PARAMS ((const char *__domainname));
 117 extern char *textdomain__ PARAMS ((const char *__domainname));
 118
 119 /* Specify that the DOMAINNAME message catalog will be found
 120    in DIRNAME rather than in the system locale data base.  */
 121 extern char *bindtextdomain PARAMS ((const char *__domainname,
 122                                   const char *__dirname));
 123 extern char *bindtextdomain__ PARAMS ((const char *__domainname,
 124                                     const char *__dirname));
 125
 126 #if ENABLE_NLS
 127
 128 /* Solaris 2.3 has the gettext function but dcgettext is missing.
 129    So we omit this optimization for Solaris 2.3.  BTW, Solaris 2.4
 130    has dcgettext.  */
 131 # if !HAVE_CATGETS && (!HAVE_GETTEXT || HAVE_DCGETTEXT)
 132
 133 #  define gettext(Msgid)                                                      \
 134      dgettext (NULL, Msgid)
 135
 136 #  define dgettext(Domainname, Msgid)                                         \
 137      dcgettext (Domainname, Msgid, LC_MESSAGES)
 138
 139 #  if defined __GNUC__ && __GNUC__ == 2 && __GNUC_MINOR__ >= 7
 140 /* This global variable is defined in loadmsgcat.c.  We need a sign,
 141    whether a new catalog was loaded, which can be associated with all
 142    translations.  */
 143 extern int _nl_msg_cat_cntr;
 144
 145 #   define dcgettext(Domainname, Msgid, Category)                             \
 146   (__extension__                                                              \
 147    ({                                                                         \
 148      char *__result;                                                          \
 149      if (__builtin_constant_p (Msgid))                                        \
 150        {                                                                      \
 151          static char *__translation__;                                        \
 152          static int __catalog_counter__;                                      \
 153          if (! __translation__ || __catalog_counter__ != _nl_msg_cat_cntr)    \
 154            {                                                                  \
 155              __translation__ =                                                \
 156                dcgettext__ (Domainname, Msgid, Category);                     \
 157              __catalog_counter__ = _nl_msg_cat_cntr;                          \
 158            }                                                                  \
 159          __result = __translation__;                                          \
 160        }                                                                      \
 161      else                                                                     \
 162        __result = dcgettext__ (Domainname, Msgid, Category);                  \
 163      __result;                                                                \
 164     }))
 165 #  endif
 166 # endif
 167
 168 #else
 169
 170 # define gettext(Msgid) (Msgid)
 171 # define dgettext(Domainname, Msgid) (Msgid)
 172 # define dcgettext(Domainname, Msgid, Category) (Msgid)
 173 # define textdomain(Domainname) ((char *) Domainname)
 174 # define bindtextdomain(Domainname, Dirname) ((char *) Dirname)
 175
 176 #endif
 177
 178 /* @@ begin of epilog @@ */
 179
 180 #ifdef __cplusplus
 181 }
 182 #endif
 183
 184 #endif