home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / gettext-0.10.24-bin.lha / share / gettext / intl / libgettext.h < prev    next >
C/C++ Source or Header  |  1996-10-12  |  6KB  |  183 lines
  1. /* libgettext.h -- Message catalogs for internationalization.
  2.    Copyright (C) 1995, 1996 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
  16. Foundation, 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. #if !defined (_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__
  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. #define gettext_noop(Str) (Str)
  90.  
  91. /* Look up MSGID in the current default message catalog for the current
  92.    LC_MESSAGES locale.  If not found, returns MSGID itself (the default
  93.    text).  */
  94. extern char *gettext PARAMS ((const char *__msgid));
  95. extern char *gettext__ PARAMS ((const char *__msgid));
  96.  
  97. /* Look up MSGID in the DOMAINNAME message catalog for the current
  98.    LC_MESSAGES locale.  */
  99. extern char *dgettext PARAMS ((const char *__domainname, const char *__msgid));
  100. extern char *dgettext__ PARAMS ((const char *__domainname,
  101.                  const char *__msgid));
  102.  
  103. /* Look up MSGID in the DOMAINNAME message catalog for the current CATEGORY
  104.    locale.  */
  105. extern char *dcgettext PARAMS ((const char *__domainname, const char *__msgid,
  106.                 int __category));
  107. extern char *dcgettext__ PARAMS ((const char *__domainname,
  108.                   const char *__msgid, int __category));
  109.  
  110.  
  111. /* Set the current default message catalog to DOMAINNAME.
  112.    If DOMAINNAME is null, return the current default.
  113.    If DOMAINNAME is "", reset to the default of "messages".  */
  114. extern char *textdomain PARAMS ((const char *__domainname));
  115. extern char *textdomain__ PARAMS ((const char *__domainname));
  116.  
  117. /* Specify that the DOMAINNAME message catalog will be found
  118.    in DIRNAME rather than in the system locale data base.  */
  119. extern char *bindtextdomain PARAMS ((const char *__domainname,
  120.                   const char *__dirname));
  121. extern char *bindtextdomain__ PARAMS ((const char *__domainname,
  122.                     const char *__dirname));
  123.  
  124. #if ENABLE_NLS
  125.  
  126. /* Solaris 2.3 has the gettext function but dcgettext is missing.
  127.    So we omit this optimization for Solaris 2.3.  BTW, Solaris 2.4
  128.    has dcgettext.  */
  129. # if !HAVE_CATGETS && (!HAVE_GETTEXT || HAVE_DCGETTEXT)
  130.  
  131. #  define gettext(Msgid)                              \
  132.      dgettext (NULL, Msgid)
  133.  
  134. #  define dgettext(Domainname, Msgid)                          \
  135.      dcgettext (Domainname, Msgid, LC_MESSAGES)
  136.  
  137. #  if defined __GNUC__ && __GNUC__ == 2 && __GNUC_MINOR__ >= 7
  138. /* This global variable is defined in loadmsgcat.c.  We need a sign,
  139.    whether a new catalog was loaded, which can be associated with all
  140.    translations.  */
  141. extern int _nl_msg_cat_cntr;
  142.  
  143. #   define dcgettext(Domainname, Msgid, Category)                  \
  144.   (__extension__                                  \
  145.    ({                                          \
  146.      char *__result;                                  \
  147.      if (__builtin_constant_p (Msgid))                          \
  148.        {                                      \
  149.      static char *__translation__;                          \
  150.      static int __catalog_counter__;                      \
  151.      if (! __translation__ || __catalog_counter__ != _nl_msg_cat_cntr)    \
  152.        {                                      \
  153.          __translation__ =                              \
  154.            dcgettext__ ((Domainname), (Msgid), (Category));              \
  155.          __catalog_counter__ = _nl_msg_cat_cntr;                  \
  156.        }                                      \
  157.      __result = __translation__;                          \
  158.        }                                      \
  159.      else                                      \
  160.        __result = dcgettext__ ((Domainname), (Msgid), (Category));          \
  161.      __result;                                      \
  162.     }))
  163. #  endif
  164. # endif
  165.  
  166. #else
  167.  
  168. # define gettext(Msgid) (Msgid)
  169. # define dgettext(Domainname, Msgid) (Msgid)
  170. # define dcgettext(Domainname, Msgid, Category) (Msgid)
  171. # define textdomain(Domainname) while (0) /* nothing */
  172. # define bindtextdomain(Domainname, Dirname) while (0) /* nothing */
  173.  
  174. #endif
  175.  
  176. /* @@ begin of epilog @@ */
  177.  
  178. #ifdef __cplusplus
  179. }
  180. #endif
  181.  
  182. #endif
  183.