doc/posix-functions/mbsrtowcs.texi

   1 @node mbsrtowcs
   2 @section @code{mbsrtowcs}
   3 @findex mbsrtowcs
   4
   5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbsrtowcs.html}
   6
   7 Gnulib module: mbsrtowcs
   8
   9 Portability problems fixed by Gnulib:
  10 @itemize
  11 @item
  12 This function is missing on some platforms:
  13 HP-UX 11.00, IRIX 6.5, Solaris 2.6, mingw, Interix 3.5.
  14 @end itemize
  15
  16 Portability problems not fixed by Gnulib:
  17 @itemize
  18 @item
  19 On AIX and Windows platforms, @code{wchar_t} is a 16-bit type and therefore cannot
  20 accommodate all Unicode characters.
  21 @item
  22 The specification is not clear about whether this function should update the
  23 conversion state when the first argument (the destination pointer) is NULL.
  24 The glibc implementation does not update the state in this case; the MacOS X
  25 and FreeBSD implementations do.
  26 For portability, when passing a NULL destination argument, it is best to pass
  27 a pointer to a temporary copy of the conversion state.
  28 @end itemize