| 1 | GNU LIBICONV - character set conversion library
|
|---|
| 2 |
|
|---|
| 3 | This library provides an iconv() implementation, for use on systems which
|
|---|
| 4 | don't have one, or whose implementation cannot convert from/to Unicode.
|
|---|
| 5 |
|
|---|
| 6 | It provides support for the encodings:
|
|---|
| 7 |
|
|---|
| 8 | European languages
|
|---|
| 9 | ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
|
|---|
| 10 | KOI8-R, KOI8-U, KOI8-RU,
|
|---|
| 11 | CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
|
|---|
| 12 | Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
|
|---|
| 13 | Mac{Cyrillic,Ukraine,Greek,Turkish},
|
|---|
| 14 | Macintosh
|
|---|
| 15 | Semitic languages
|
|---|
| 16 | ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
|
|---|
| 17 | Japanese
|
|---|
| 18 | EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1,
|
|---|
| 19 | ISO-2022-JP-MS
|
|---|
| 20 | Chinese
|
|---|
| 21 | EUC-CN, HZ, GBK, CP936, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS,
|
|---|
| 22 | BIG5-HKSCS:2004, BIG5-HKSCS:2001, BIG5-HKSCS:1999, ISO-2022-CN,
|
|---|
| 23 | ISO-2022-CN-EXT
|
|---|
| 24 | Korean
|
|---|
| 25 | EUC-KR, CP949, ISO-2022-KR, JOHAB
|
|---|
| 26 | Armenian
|
|---|
| 27 | ARMSCII-8
|
|---|
| 28 | Georgian
|
|---|
| 29 | Georgian-Academy, Georgian-PS
|
|---|
| 30 | Tajik
|
|---|
| 31 | KOI8-T
|
|---|
| 32 | Kazakh
|
|---|
| 33 | PT154, RK1048
|
|---|
| 34 | Thai
|
|---|
| 35 | ISO-8859-11, TIS-620, CP874, MacThai
|
|---|
| 36 | Laotian
|
|---|
| 37 | MuleLao-1, CP1133
|
|---|
| 38 | Vietnamese
|
|---|
| 39 | VISCII, TCVN, CP1258
|
|---|
| 40 | Platform specifics
|
|---|
| 41 | HP-ROMAN8, NEXTSTEP
|
|---|
| 42 | Full Unicode
|
|---|
| 43 | UTF-8
|
|---|
| 44 | UCS-2, UCS-2BE, UCS-2LE
|
|---|
| 45 | UCS-4, UCS-4BE, UCS-4LE
|
|---|
| 46 | UTF-16, UTF-16BE, UTF-16LE
|
|---|
| 47 | UTF-32, UTF-32BE, UTF-32LE
|
|---|
| 48 | UTF-7
|
|---|
| 49 | C99, JAVA
|
|---|
| 50 | Full Unicode, in terms of 'uint16_t' or 'uint32_t'
|
|---|
| 51 | (with machine dependent endianness and alignment)
|
|---|
| 52 | UCS-2-INTERNAL, UCS-4-INTERNAL
|
|---|
| 53 | Locale dependent, in terms of 'char' or 'wchar_t'
|
|---|
| 54 | (with machine dependent endianness and alignment, and with OS and
|
|---|
| 55 | locale dependent semantics)
|
|---|
| 56 | char, wchar_t
|
|---|
| 57 | The empty encoding name "" is equivalent to "char": it denotes the
|
|---|
| 58 | locale dependent character encoding.
|
|---|
| 59 |
|
|---|
| 60 | When configured with the option --enable-extra-encodings, it also provides
|
|---|
| 61 | support for a few extra encodings:
|
|---|
| 62 |
|
|---|
| 63 | European languages
|
|---|
| 64 | CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
|
|---|
| 65 | Semitic languages
|
|---|
| 66 | CP864
|
|---|
| 67 | Japanese
|
|---|
| 68 | EUC-JISX0213, Shift_JISX0213, ISO-2022-JP-3
|
|---|
| 69 | Chinese
|
|---|
| 70 | BIG5-2003 (experimental)
|
|---|
| 71 | Turkmen
|
|---|
| 72 | TDS565
|
|---|
| 73 | Platform specifics
|
|---|
| 74 | ATARIST, RISCOS-LATIN1
|
|---|
| 75 |
|
|---|
| 76 | It can convert from any of these encodings to any other, through Unicode
|
|---|
| 77 | conversion.
|
|---|
| 78 |
|
|---|
| 79 | It has also some limited support for transliteration, i.e. when a character
|
|---|
| 80 | cannot be represented in the target character set, it can be approximated
|
|---|
| 81 | through one or several similarly looking characters. Transliteration is
|
|---|
| 82 | activated when "//TRANSLIT" is appended to the target encoding name.
|
|---|
| 83 |
|
|---|
| 84 | libiconv is for you if your application needs to support multiple character
|
|---|
| 85 | encodings, but that support lacks from your system.
|
|---|
| 86 |
|
|---|
| 87 |
|
|---|
| 88 | Installation
|
|---|
| 89 | ------------
|
|---|
| 90 |
|
|---|
| 91 | As usual for GNU packages:
|
|---|
| 92 |
|
|---|
| 93 | $ ./configure --prefix=[[PREFIX]] where [[PREFIX]] is e.g. $HOME/local
|
|---|
| 94 | $ make
|
|---|
| 95 | $ make install
|
|---|
| 96 |
|
|---|
| 97 | After installing GNU libiconv for the first time, it is recommended to
|
|---|
| 98 | recompile and reinstall GNU gettext, so that it can take advantage of
|
|---|
| 99 | libiconv.
|
|---|
| 100 |
|
|---|
| 101 | On systems other than GNU/Linux, the iconv program will be internationalized
|
|---|
| 102 | only if GNU gettext has been built and installed before GNU libiconv. This
|
|---|
| 103 | means that the first time GNU libiconv is installed, we have a circular
|
|---|
| 104 | dependency between the GNU libiconv and GNU gettext packages, which can be
|
|---|
| 105 | resolved by building and installing either
|
|---|
| 106 | - first libiconv, then gettext, then libiconv again,
|
|---|
| 107 | or (on systems supporting shared libraries, excluding AIX)
|
|---|
| 108 | - first gettext, then libiconv, then gettext again.
|
|---|
| 109 | Recall that before building a package for the second time, you need to erase
|
|---|
| 110 | the traces of the first build by running "make distclean".
|
|---|
| 111 |
|
|---|
| 112 | This library installs:
|
|---|
| 113 | - a library 'libiconv.so',
|
|---|
| 114 | - a header file '<iconv.h>'.
|
|---|
| 115 |
|
|---|
| 116 | To use it, simply #include <iconv.h> and use the functions.
|
|---|
| 117 |
|
|---|
| 118 | To use it in an autoconfiguring package:
|
|---|
| 119 | - If you don't use automake, append m4/iconv.m4 to your aclocal.m4
|
|---|
| 120 | file.
|
|---|
| 121 | - If you do use automake, add m4/iconv.m4 to your m4 macro repository.
|
|---|
| 122 | - Add to the link command line of libraries and executables that use
|
|---|
| 123 | the functions the placeholder @LIBICONV@ (or, if using libtool for
|
|---|
| 124 | the link, @LTLIBICONV@). If you use automake, the right place for
|
|---|
| 125 | these additions are the *_LDADD variables.
|
|---|
| 126 | Note that 'iconv.m4' is also part of GNU gnulib, available through
|
|---|
| 127 | the gnulib module 'iconv'.
|
|---|
| 128 |
|
|---|
| 129 |
|
|---|
| 130 | Copyright
|
|---|
| 131 | ---------
|
|---|
| 132 |
|
|---|
| 133 | The libiconv and libcharset _libraries_ and their header files are under LGPL,
|
|---|
| 134 | see file COPYING.LIB.
|
|---|
| 135 |
|
|---|
| 136 | The iconv _program_ and the documentation are under GPL, see file COPYING.
|
|---|
| 137 |
|
|---|
| 138 |
|
|---|
| 139 | Download
|
|---|
| 140 | --------
|
|---|
| 141 |
|
|---|
| 142 | https://ftp.gnu.org/gnu/libiconv/libiconv-1.16.tar.gz
|
|---|
| 143 |
|
|---|
| 144 | Homepage
|
|---|
| 145 | --------
|
|---|
| 146 |
|
|---|
| 147 | https://www.gnu.org/software/libiconv/
|
|---|
| 148 |
|
|---|
| 149 | Bug reports to
|
|---|
| 150 | --------------
|
|---|
| 151 |
|
|---|
| 152 | <bug-gnu-libiconv@gnu.org>
|
|---|
| 153 |
|
|---|
| 154 |
|
|---|
| 155 | Bruno Haible <bruno@clisp.org>
|
|---|
