mbstowcs
- convert a character string to a wide-character string
LIBRARY
Lb libc
SYNOPSIS
#include <stdlib.h> size_t
Fo mbstowcs
Fa wchar_t * restrict wcstring const char * restrict mbstring
Fa size_t nwchars
Fc
DESCRIPTION
The
mbstowcs ();
function converts a multibyte character string
Fa mbstring
beginning in the initial conversion state
into a wide character string
Fa wcstring .
No more than
Fa nwchars
wide characters are stored.
A terminating null wide character is appended if there is room.
RETURN VALUES
The
mbstowcs ();
function returns the number of wide characters converted,
not counting any terminating null wide character, or -1
if an invalid multibyte character was encountered.
