---

10.18.1 iconv ¶

POSIX specification:
https://pubs.opengroup.org/onlinepubs/9799919799/functions/iconv.html

Gnulib module: iconv

Portability problems fixed by Gnulib:

• GNU libiconv is not found if installed in $PREFIX/lib.

Portability problems handled by Gnulib (in the sense that HAVE_ICONV does not get defined if the system’s iconv function has this problem):

• Failures are not distinguishable from successful returns on some platforms: macOS 14.4, AIX 5.1..7.2, Solaris 10.
• A buffer overrun can occur on some platforms: AIX 6.1..7.1.

Portability problems not fixed by Gnulib:

• This function is missing on some platforms: FreeBSD 6.0, OpenBSD 7.5, Minix 3.1.8, Cygwin 2.9, mingw, MSVC 14, Android 8.1, when GNU libiconv is not installed.
• This function was not correctly implemented in glibc versions before 2.2.
• When iconv encounters an input character that is valid but that cannot be converted to the output character set, glibc’s and GNU libiconv’s iconv stop the conversion. Some other implementations put an implementation-defined character into the output buffer. Gnulib provides higher-level facilities striconv and striconveh (wrappers around iconv) that deal with conversion errors in a platform independent way.
• This function returns a positive return value, instead of zero, when converting from ISO-8859-1 to UTF-8 on HP-UX 11.