Mention platform-dependent limitations of wchar_t.
[gnulib.git] / doc / posix-functions / mbsnrtowcs.texi
1 @node mbsnrtowcs
2 @section @code{mbsnrtowcs}
3 @findex mbsnrtowcs
4
5 POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbsnrtowcs.html}
6
7 Gnulib module: mbsnrtowcs
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 3.0, OpenBSD 3.8, AIX 4.3.2, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin, mingw, Interix 3.5, BeOS.
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, MacOS X, FreeBSD implementations do update the state in this case.
25 For portability, when passing a NULL destination argument, it is best to pass
26 a pointer to a temporary copy of the conversion state.
27 @end itemize