view doc/posix-functions/mbsrtowcs.texi @ 15607:6355dc4626b5

doc: Update regarding MSVC 9. * doc/gnulib-intro.texi (Target Platforms): Classify MSVC as "rarely tested". * doc/posix-functions/*.texi: Update with info about MSVC 9. * doc/posix-headers/*.texi: Likewise. * doc/pastposix-functions/*.texi: Likewise. * doc/glibc-functions/*.texi: Likewise. * doc/glibc-headers/*.texi: Likewise.
author Bruno Haible <bruno@clisp.org>
date Sun, 11 Sep 2011 21:56:17 +0200
parents 847372253549
children 498a2211d839
line wrap: on
line source

@node mbsrtowcs
@section @code{mbsrtowcs}
@findex mbsrtowcs

POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/mbsrtowcs.html}

Gnulib module: mbsrtowcs

Portability problems fixed by Gnulib:
@itemize
@item
This function is missing on some platforms:
Minix 3.1.8, HP-UX 11.00, IRIX 6.5, Solaris 2.6, mingw, Interix 3.5.
@item
This function does not work on some platforms:
HP-UX 11, Solaris 11 2010-11.
@item
This function does not work when the first argument is NULL on some platforms:
mingw.
@end itemize

Portability problems not fixed by Gnulib:
@itemize
@item
On AIX and Windows platforms, @code{wchar_t} is a 16-bit type and therefore cannot
accommodate all Unicode characters.
@item
The specification is not clear about whether this function should update the
conversion state when the first argument (the destination pointer) is NULL.
The glibc implementation does not update the state in this case; the MacOS X
and FreeBSD implementations do.
For portability, when passing a NULL destination argument, it is best to pass
a pointer to a temporary copy of the conversion state.
@end itemize