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