cppp-reiconv

A character set conversion library based on GNU LIBICONV.

Instruction

This library provides some charset conversation function for The C++ Plus Project.

It provides support for the encodings:

European languages
- ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16},
- KOI8-R, KOI8-U, KOI8-RU,
- CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
- Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
- Mac{Cyrillic,Ukraine,Greek,Turkish},
- Macintosh
Semitic languages
- ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}
Japanese
- EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1,
- ISO-2022-JP-MS
Chinese
- EUC-CN, HZ, GBK, CP936, GB18030, GB18030:2022, EUC-TW, BIG5, CP950,
- BIG5-HKSCS, BIG5-HKSCS:2004, BIG5-HKSCS:2001, BIG5-HKSCS:1999,
- ISO-2022-CN, ISO-2022-CN-EXT
Korean
- EUC-KR, CP949, ISO-2022-KR, JOHAB
Armenian
- ARMSCII-8
Georgian
- Georgian-Academy, Georgian-PS
Tajik
- KOI8-T
Kazakh
- PT154, RK1048
Thai
- ISO-8859-11, TIS-620, CP874, MacThai
Laotian
- MuleLao-1, CP1133
Vietnamese
- VISCII, TCVN, CP1258
Platform specifics
- HP-ROMAN8, NEXTSTEP
Full Unicode
- UTF-8
- UCS-2, UCS-2BE, UCS-2LE
- UCS-4, UCS-4BE, UCS-4LE
- UTF-16, UTF-16BE, UTF-16LE
- UTF-32, UTF-32BE, UTF-32LE
- UTF-7
- C99, JAVA
Full Unicode, in terms of 'uint16_t' or 'uint32_t'
- (with machine dependent endianness and alignment)
- UCS-2-INTERNAL, UCS-4-INTERNAL

When configured with the option -DENABLE_EXTRA, it also provides support for a few extra encodings:

European languages
- CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}
Semitic languages
- CP864
Japanese
- EUC-JISX0213, Shift_JISX0213, ISO-2022-JP-3
Chinese
- BIG5-2003 (experimental)
Turkmen
- TDS565
Platform specifics
- ATARIST, RISCOS-LATIN1
EBCDIC compatible (not ASCII compatible, very rarely used)
- European languages
- - IBM-{037,273,277,278,280,282,284,285,297,423,500,870,871,875,880},
- - IBM-{905,924,1025,1026,1047,1112,1122,1123,1140,1141,1142,1143},
- - IBM-{1144,1145,1146,1147,1148,1149,1153,1154,1155,1156,1157,1158},
- - IBM-{1165,1166,4971}
- Semitic languages
- - IBM-{424,425,12712,16804}
- Persian
- - IBM-1097
- Thai
- - IBM-{838,1160}
- Laotian
- - IBM-1132
- Vietnamese
- - IBM-{1130,1164}
- Indic languages
- - IBM-1137

It can convert from any of these encodings to any other, through Unicode conversion.

cppp-reiconv is for you if your application needs to support multiple character encodings, but that support lacks from your system.

We use CMake for build

Standard build

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=[[PREFIX]]
cmake --build . --config=Release
cmake --install .

Full build

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=[[PREFIX]] -DENABLE_EXTRA=ON
cmake --build . --config=Release
cmake --install .

When use full build, extra encodings will be enabled.

Build with test suite

mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=[[PREFIX]] -DENABLE_EXTRA=ON -DENABLE_TEST=ON
cmake --build . --config=Release
cmake --install .

This library installs:

To use it, simply #include <cppp/reiconv.hpp> and import the lib to use the functions.

The cppp-reiconv is under LGPLv3, see file COPYING.