[WIN-ICONV] Update to git commit 8765259.
[reactos.git] / reactos / lib / 3rdparty / libwin-iconv / readme.txt
1 win_iconv is a iconv implementation using Win32 API to convert.
2
3 win_iconv is placed in the public domain.
4
5 ENVIRONMENT VARIABLE:
6 WINICONV_LIBICONV_DLL
7 If $WINICONV_LIBICONV_DLL is set, win_iconv uses the DLL. If
8 loading the DLL or iconv_open() failed, falls back to internal
9 conversion. If a few DLL are specified as comma separated list,
10 the first loadable DLL is used. The DLL should have
11 iconv_open(), iconv_close() and iconv(). Or libiconv_open(),
12 libiconv_close() and libiconv().
13 (only available when USE_LIBICONV_DLL is defined at compile time)
14
15 Win32 API does not support strict encoding conversion for some codepage.
16 And MLang function drops or replaces invalid bytes and does not return
17 useful error status as iconv does. This implementation cannot be used for
18 encoding validation purpose.
19
20 Yukihiro Nakadaira <yukihiro.nakadaira@gmail.com>