![cppp-reiconv logo](https://cppp-project.github.io/cppp-res.github.io/images/reiconv-icon.png)

# 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/)