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 @item
  17 A buffer overrun can occur on some platforms:
  18 AIX 6.1..7.1.
  19 @end itemize
  20
  21 Portability problems not fixed by Gnulib:
  22 @itemize
  23 @item
  24 This function is missing on some platforms:
  25 MacOS X 10.5, FreeBSD 6.0, OpenBSD 3.8, IRIX 5.3, Cygwin, mingw, BeOS,
  26 when GNU libiconv is not installed.
  27 @item
  28 This function was not correctly implemented in glibc versions before 2.2.
  29 @item
  30 When @code{iconv} encounters an input character that is valid but that
  31 cannot be converted to the output character set, glibc's and GNU libiconv's
  32 @code{iconv} stop the conversion.  Some other implementations put an
  33 implementation-defined character into the output buffer.  ---
  34 Gnulib provides higher-level facilities @code{striconv} and @code{striconveh}
  35 (wrappers around @code{iconv}) that deal with conversion errors in a platform
  36 independent way.
  37 @item
  38 This function returns a positive return value, instead of zero, when
  39 converting from ISO-8859-1 to UTF-8 on HP-UX 11.
  40 @end itemize