7bd2cbda33e7bc54c351d92fc1bfaaa660d10a3f
[pspp] / 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 @item
15 This function does not work on some platforms:
16 HP-UX 11, Solaris 11 2010-11.
17 @item
18 This function does not work when the first argument is NULL on some platforms:
19 mingw.
20 @end itemize
21
22 Portability problems not fixed by Gnulib:
23 @itemize
24 @item
25 On AIX and Windows platforms, @code{wchar_t} is a 16-bit type and therefore cannot
26 accommodate all Unicode characters.
27 @item
28 The specification is not clear about whether this function should update the
29 conversion state when the first argument (the destination pointer) is NULL.
30 The glibc implementation does not update the state in this case; the MacOS X
31 and FreeBSD implementations do.
32 For portability, when passing a NULL destination argument, it is best to pass
33 a pointer to a temporary copy of the conversion state.
34 @end itemize