c_cpp/lib/gnulib/doc/posix-functions/iconv_open.texi

   1 @node iconv_open
   2 @section @code{iconv_open}
   3 @findex iconv_open
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/iconv_open.html}
   6
   7 Gnulib module: iconv, iconv_open, iconv_open-utf
   8
   9 Portability problems fixed by either Gnulib module @code{iconv} or @code{iconv_open}:
  10 @itemize
  11 @item
  12 GNU libiconv is not found if installed in @file{$PREFIX/lib}.
  13 @item
  14 No converter from EUC-JP to UTF-8 is provided on some platforms:
  15 HP-UX 11.
  16 @end itemize
  17
  18 Portability problems fixed by Gnulib module @code{iconv_open}:
  19 @itemize
  20 @item
  21 This function recognizes only non-standard aliases for many encodings (not
  22 the IANA registered encoding names) on many platforms:
  23 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11.
  24 @end itemize
  25
  26 Portability problems fixed by Gnulib module @code{iconv_open-utf}:
  27 @itemize
  28 @item
  29 This function does not support the encodings UTF-16BE, UTF-16LE, UTF-32BE,
  30 UTF-32LE on many platforms:
  31 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 8.
  32 @end itemize
  33
  34 Portability problems not fixed by Gnulib:
  35 @itemize
  36 @item
  37 This function is missing on some platforms:
  38 Mac OS X 10.5, FreeBSD 6.0, OpenBSD 3.8, Minix 3.1.8, IRIX 5.3, Cygwin, mingw, MSVC 9, BeOS,
  39 when GNU libiconv is not installed.
  40 @item
  41 For some encodings A and B, this function cannot convert directly from A to B,
  42 although an indirect conversion from A through UTF-8 to B is possible.  This
  43 occurs on some platforms: Solaris 11 2010-11.  Gnulib provides a higher-level
  44 facility @code{striconveh} (a wrapper around @code{iconv}) that deals with
  45 this problem.
  46 @item
  47 The set of supported encodings and conversions is system dependent.
  48 @end itemize