8e966b5160c54b7bee6adccffd8af0006c4f10bc
[gnulib.git] / doc / posix-functions / mbrtowc.texi
1 @node mbrtowc
2 @section @code{mbrtowc}
3 @findex mbrtowc
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbrtowc.html}
6
7 Gnulib module: mbrtowc
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 put the state into non-initial state when parsing an
16 incomplete multibyte character on some platforms:
17 AIX 5.1, OSF/1 5.1.
18 @item
19 This function does not produce correct results in the zh_CN.GB18030 locale on
20 some platforms:
21 Solaris 8.
22 @item
23 This function fails if the @code{pwc} argument is NULL on some platforms:
24 Solaris 7.
25 @item
26 This function does not ignore the @code{pwc} argument if the string argument is
27 NULL on some platforms:
28 OSF/1 5.1.
29 @item
30 This function returns the total number of bytes that make up the multibyte
31 character, not the number of bytes that were needed to complete the multibyte
32 character, on some platforms:
33 HP-UX 11.11, Solaris 11 2010-11, mingw.
34 @item
35 This function may not return 0 when parsing the NUL character on some platforms:
36 Solaris 9.
37 @end itemize
38
39 Portability problems not fixed by Gnulib:
40 @itemize
41 @item
42 On AIX and Windows platforms, @code{wchar_t} is a 16-bit type and therefore cannot
43 accommodate all Unicode characters.
44 @end itemize