doc/posix-functions/iconv.texi

   1 @node iconv
   2 @section @code{iconv}
   3 @findex iconv
   4
   5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/iconv.html}
   6
   7 Gnulib module: iconv
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 GNU libiconv is not found if installed in @file{$PREFIX/lib}.
  13 @item
  14 Failures are not distinguishable from successful returns on some platforms:
  15 AIX 5.1, Solaris 10.
  16 @end itemize
  17
  18 Portability problems not fixed by Gnulib:
  19 @itemize
  20 @item
  21 This function is missing on some platforms:
  22 MacOS X 10.3, FreeBSD 6.0, OpenBSD 3.8, IRIX 5.3, Cygwin, mingw, BeOS,
  23 when GNU libiconv is not installed.
  24 @item
  25 This function was not correctly implemented in glibc versions before 2.2.
  26 @item
  27 When @code{iconv} encounters an input character that is valid but that can
  28 not be converted to the output character set, glibc's and GNU libiconv's
  29 @code{iconv} stop the conversion.  Some other implementations put an
  30 implementation-defined character into the output buffer.  ---
  31 Gnulib provides higher-level facilities @code{striconv} and @code{striconveh}
  32 (wrappers around @code{iconv}) that deal with conversion errors in a platform
  33 independent way.
  34 @end itemize