iconv
=====

POSIX specification:
 http://www.opengroup.org/onlinepubs/9699919799/functions/iconv.html

Gnulib module: iconv

Portability problems fixed by Gnulib:

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

  * Failures are not distinguishable from successful returns on some platforms: AIX 5.1, 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: MacOS X 10.3, FreeBSD 6.0, OpenBSD 3.8, IRIX 5.3, Cygwin, mingw, BeOS, 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 can not 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.