154 lines
3.9 KiB
Markdown
154 lines
3.9 KiB
Markdown
|
|
||
|
|
|
||
|
|
# 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.
|
||
|
|
|
||
|
|
|
||
|
|
# Build and installation
|
||
|
|
|
||
|
|
We use CMake for build
|
||
|
|
|
||
|
|
+ Standard build
|
||
|
|
```shell
|
||
|
|
mkdir build
|
||
|
|
cd build
|
||
|
|
cmake .. -DCMAKE_INSTALL_PREFIX=[[PREFIX]]
|
||
|
|
cmake --build . --config=Release
|
||
|
|
cmake --install .
|
||
|
|
```
|
||
|
|
|
||
|
|
+ Full build
|
||
|
|
```shell
|
||
|
|
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
|
||
|
|
```shell
|
||
|
|
mkdir build
|
||
|
|
cd build
|
||
|
|
cmake .. -DCMAKE_INSTALL_PREFIX=[[PREFIX]] -DENABLE_EXTRA=ON -DENABLE_TEST=ON
|
||
|
|
cmake --build . --config=Release
|
||
|
|
cmake --install .
|
||
|
|
```
|
||
|
|
|
||
|
|
# Install
|
||
|
|
This library installs:
|
||
|
|
- a shared library 'libcppp-reiconv'.
|
||
|
|
- a static library 'libcppp-reiconv.static'.
|
||
|
|
- a header file '<cppp/reiconv.hpp>'.
|
||
|
|
|
||
|
|
To use it, simply #include <cppp/reiconv.hpp> and import the lib to use the functions.
|
||
|
|
|
||
|
|
# Copyright
|
||
|
|
|
||
|
|
The cppp-reiconv is under LGPLv3,
|
||
|
|
see file [COPYING](./COPYING).
|
||
|
|
|
||
|
|
# Download
|
||
|
|
|
||
|
|
https://github.com/cppp-project/cppp-reiconv/releases
|
||
|
|
|
||
|
|
# Homepage
|
||
|
|
|
||
|
|
https://github.com/cppp-project/cppp-reiconv
|
||
|
|
|
||
|
|
# Bug reports
|
||
|
|
+ Create a issue on GitHub [Report now](https://github.com/cppp-project/cppp-reiconv/issues/new/)
|