cups/language.h

   1 /*
   2  * Multi-language support for CUPS.
   3  *
   4  * Copyright 2007-2011 by Apple Inc.
   5  * Copyright 1997-2006 by Easy Software Products.
   6  *
   7  * These coded instructions, statements, and computer programs are the
   8  * property of Apple Inc. and are protected by Federal copyright
   9  * law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  10  * which should have been included with this file.  If this file is
  11  * missing or damaged, see the license at "http://www.cups.org/".
  12  *
  13  * This file is subject to the Apple OS-Developed Software exception.
  14  */
  15
  16 #ifndef _CUPS_LANGUAGE_H_
  17 #  define _CUPS_LANGUAGE_H_
  18
  19 /*
  20  * Include necessary headers...
  21  */
  22
  23 #  include <locale.h>
  24 #  include "array.h"
  25
  26 #  ifdef __cplusplus
  27 extern "C" {
  28 #  endif /* __cplusplus */
  29
  30
  31 /*
  32  * Types...
  33  */
  34
  35 typedef enum cups_encoding_e            /**** Language Encodings @exclude all@ ****/
  36 {
  37   CUPS_AUTO_ENCODING = -1,              /* Auto-detect the encoding @private@ */
  38   CUPS_US_ASCII,                        /* US ASCII */
  39   CUPS_ISO8859_1,                       /* ISO-8859-1 */
  40   CUPS_ISO8859_2,                       /* ISO-8859-2 */
  41   CUPS_ISO8859_3,                       /* ISO-8859-3 */
  42   CUPS_ISO8859_4,                       /* ISO-8859-4 */
  43   CUPS_ISO8859_5,                       /* ISO-8859-5 */
  44   CUPS_ISO8859_6,                       /* ISO-8859-6 */
  45   CUPS_ISO8859_7,                       /* ISO-8859-7 */
  46   CUPS_ISO8859_8,                       /* ISO-8859-8 */
  47   CUPS_ISO8859_9,                       /* ISO-8859-9 */
  48   CUPS_ISO8859_10,                      /* ISO-8859-10 */
  49   CUPS_UTF8,                            /* UTF-8 */
  50   CUPS_ISO8859_13,                      /* ISO-8859-13 */
  51   CUPS_ISO8859_14,                      /* ISO-8859-14 */
  52   CUPS_ISO8859_15,                      /* ISO-8859-15 */
  53   CUPS_WINDOWS_874,                     /* CP-874 */
  54   CUPS_WINDOWS_1250,                    /* CP-1250 */
  55   CUPS_WINDOWS_1251,                    /* CP-1251 */
  56   CUPS_WINDOWS_1252,                    /* CP-1252 */
  57   CUPS_WINDOWS_1253,                    /* CP-1253 */
  58   CUPS_WINDOWS_1254,                    /* CP-1254 */
  59   CUPS_WINDOWS_1255,                    /* CP-1255 */
  60   CUPS_WINDOWS_1256,                    /* CP-1256 */
  61   CUPS_WINDOWS_1257,                    /* CP-1257 */
  62   CUPS_WINDOWS_1258,                    /* CP-1258 */
  63   CUPS_KOI8_R,                          /* KOI-8-R */
  64   CUPS_KOI8_U,                          /* KOI-8-U */
  65   CUPS_ISO8859_11,                      /* ISO-8859-11 */
  66   CUPS_ISO8859_16,                      /* ISO-8859-16 */
  67   CUPS_MAC_ROMAN,                       /* MacRoman */
  68   CUPS_ENCODING_SBCS_END = 63,          /* End of single-byte encodings @private@ */
  69
  70   CUPS_WINDOWS_932,                     /* Japanese JIS X0208-1990 */
  71   CUPS_WINDOWS_936,                     /* Simplified Chinese GB 2312-80 */
  72   CUPS_WINDOWS_949,                     /* Korean KS C5601-1992 */
  73   CUPS_WINDOWS_950,                     /* Traditional Chinese Big Five */
  74   CUPS_WINDOWS_1361,                    /* Korean Johab */
  75   CUPS_ENCODING_DBCS_END = 127,         /* End of double-byte encodings @private@ */
  76
  77   CUPS_EUC_CN,                          /* EUC Simplified Chinese */
  78   CUPS_EUC_JP,                          /* EUC Japanese */
  79   CUPS_EUC_KR,                          /* EUC Korean */
  80   CUPS_EUC_TW,                          /* EUC Traditional Chinese */
  81   CUPS_JIS_X0213,                       /* JIS X0213 aka Shift JIS */
  82   CUPS_ENCODING_VBCS_END = 191          /* End of variable-length encodings @private@ */
  83 } cups_encoding_t;
  84
  85 typedef struct cups_lang_s              /**** Language Cache Structure ****/
  86 {
  87   struct cups_lang_s    *next;          /* Next language in cache */
  88   int                   used;           /* Number of times this entry has been used. */
  89   cups_encoding_t       encoding;       /* Text encoding */
  90   char                  language[16];   /* Language/locale name */
  91   cups_array_t          *strings;       /* Message strings @private@ */
  92 } cups_lang_t;
  93
  94
  95 /*
  96  * Prototypes...
  97  */
  98
  99 extern cups_lang_t      *cupsLangDefault(void);
 100 extern const char       *cupsLangEncoding(cups_lang_t *lang);
 101 extern void             cupsLangFlush(void);
 102 extern void             cupsLangFree(cups_lang_t *lang);
 103 extern cups_lang_t      *cupsLangGet(const char *language);
 104
 105 #  ifdef __cplusplus
 106 }
 107 #  endif /* __cplusplus */
 108
 109 #endif /* !_CUPS_LANGUAGE_H_ */