gnulib/import/localcharset.h

   1 /* Determine a canonical name for the current locale's character encoding.
   2    Copyright (C) 2000-2003, 2009-2022 Free Software Foundation, Inc.
   3    This file is part of the GNU CHARSET Library.
   4
   5    This file is free software: you can redistribute it and/or modify
   6    it under the terms of the GNU Lesser General Public License as
   7    published by the Free Software Foundation; either version 2.1 of the
   8    License, or (at your option) any later version.
   9
  10    This file is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13    GNU Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public License
  16    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  17
  18 #ifndef _LOCALCHARSET_H
  19 #define _LOCALCHARSET_H
  20
  21
  22 #ifdef __cplusplus
  23 extern "C" {
  24 #endif
  25
  26
  27 /* Determine the current locale's character encoding, and canonicalize it
  28    into one of the canonical names listed below.
  29    The result must not be freed; it is statically allocated.  The result
  30    becomes invalid when setlocale() is used to change the global locale, or
  31    when the value of one of the environment variables LC_ALL, LC_CTYPE, LANG
  32    is changed; threads in multithreaded programs should not do this.
  33    If the canonical name cannot be determined, the result is a non-canonical
  34    name.  */
  35 extern const char * locale_charset (void);
  36
  37 /* About GNU canonical names for character encodings:
  38
  39    Every canonical name must be supported by GNU libiconv.  Support by GNU libc
  40    is also desirable.
  41
  42    The name is case insensitive.  Usually an upper case MIME charset name is
  43    preferred.
  44
  45    The current list of these GNU canonical names is:
  46
  47        name              MIME?             used by which systems
  48                                     (darwin = Mac OS X, windows = native Windows)
  49
  50    ASCII, ANSI_X3.4-1968       glibc solaris freebsd netbsd darwin minix cygwin
  51    ISO-8859-1              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
  52    ISO-8859-2              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
  53    ISO-8859-3              Y   glibc solaris cygwin
  54    ISO-8859-4              Y   hpux osf solaris freebsd netbsd openbsd darwin
  55    ISO-8859-5              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
  56    ISO-8859-6              Y   glibc aix hpux solaris cygwin
  57    ISO-8859-7              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
  58    ISO-8859-8              Y   glibc aix hpux osf solaris cygwin zos
  59    ISO-8859-9              Y   glibc aix hpux irix osf solaris freebsd darwin cygwin zos
  60    ISO-8859-13                 glibc hpux solaris freebsd netbsd openbsd darwin cygwin
  61    ISO-8859-14                 glibc cygwin
  62    ISO-8859-15                 glibc aix irix osf solaris freebsd netbsd openbsd darwin cygwin
  63    KOI8-R                  Y   glibc hpux solaris freebsd netbsd openbsd darwin
  64    KOI8-U                  Y   glibc freebsd netbsd openbsd darwin cygwin
  65    KOI8-T                      glibc
  66    CP437                       dos
  67    CP775                       dos
  68    CP850                       aix osf dos
  69    CP852                       dos
  70    CP855                       dos
  71    CP856                       aix
  72    CP857                       dos
  73    CP861                       dos
  74    CP862                       dos
  75    CP864                       dos
  76    CP865                       dos
  77    CP866                       freebsd netbsd openbsd darwin dos
  78    CP869                       dos
  79    CP874                       windows dos
  80    CP922                       aix
  81    CP932                       aix cygwin windows dos
  82    CP943                       aix zos
  83    CP949                       osf darwin windows dos
  84    CP950                       windows dos
  85    CP1046                      aix
  86    CP1124                      aix
  87    CP1125                      dos
  88    CP1129                      aix
  89    CP1131                      freebsd darwin
  90    CP1250                      windows
  91    CP1251                      glibc hpux solaris freebsd netbsd openbsd darwin cygwin windows
  92    CP1252                      aix windows
  93    CP1253                      windows
  94    CP1254                      windows
  95    CP1255                      glibc windows
  96    CP1256                      windows
  97    CP1257                      windows
  98    GB2312                  Y   glibc aix hpux irix solaris freebsd netbsd darwin cygwin zos
  99    EUC-JP                  Y   glibc aix hpux irix osf solaris freebsd netbsd darwin cygwin
 100    EUC-KR                  Y   glibc aix hpux irix osf solaris freebsd netbsd darwin cygwin zos
 101    EUC-TW                      glibc aix hpux irix osf solaris netbsd
 102    BIG5                    Y   glibc aix hpux osf solaris freebsd netbsd darwin cygwin zos
 103    BIG5-HKSCS                  glibc hpux solaris netbsd darwin
 104    GBK                         glibc aix osf solaris freebsd darwin cygwin windows dos
 105    GB18030                     glibc hpux solaris freebsd netbsd darwin
 106    SHIFT_JIS               Y   hpux osf solaris freebsd netbsd darwin
 107    JOHAB                       glibc solaris windows
 108    TIS-620                     glibc aix hpux osf solaris cygwin zos
 109    VISCII                  Y   glibc
 110    TCVN5712-1                  glibc
 111    ARMSCII-8                   glibc freebsd netbsd darwin
 112    GEORGIAN-PS                 glibc cygwin
 113    PT154                       glibc netbsd cygwin
 114    HP-ROMAN8                   hpux
 115    HP-ARABIC8                  hpux
 116    HP-GREEK8                   hpux
 117    HP-HEBREW8                  hpux
 118    HP-TURKISH8                 hpux
 119    HP-KANA8                    hpux
 120    DEC-KANJI                   osf
 121    DEC-HANYU                   osf
 122    UTF-8                   Y   glibc aix hpux osf solaris netbsd darwin cygwin zos
 123
 124    Note: Names which are not marked as being a MIME name should not be used in
 125    Internet protocols for information interchange (mail, news, etc.).
 126
 127    Note: ASCII and ANSI_X3.4-1968 are synonymous canonical names.  Applications
 128    must understand both names and treat them as equivalent.
 129  */
 130
 131
 132 #ifdef __cplusplus
 133 }
 134 #endif
 135
 136
 137 #endif /* _LOCALCHARSET_H */