pSOSystem System Calls - Read

mbstowcs pREPC+ System Calls
mbstowcs Converts a multibyte character string into a wide character string.
#include
size_t mbstowcs (
wchar_t *pwcs, /* wide string */
const char *s, /* original multibyte string */
size_t n /* wide string length */
Description
Arguments
Return Value
Error Codes
The mbstowcs() function converts a sequence of multibyte characters that begins
in the initial shift state from the array pointed to by s into a sequence of
corresponding codes and stores not more than n codes into the array pointed to by
pwcs. No multibyte characters that follow a null character (which is converted into a
code with value zero) will be examined or converted. Each multibyte character is
converted as if by a call to the mbtowc() function, except that the shift state of the
mbtowc() function is not affected.
If copying takes place between objects that overlap, the behavior is undefined.
pwcs Points to the array where mbstowcs() stores the converted string.
s Points to the string to be converted.
n Specifies the length of pwcs.
If an invalid multibyte character is encountered, mbstowcs() returns (size_t)-1.
Otherwise, it returns the number of array elements modified, not including a
terminating zero code, if any.
None.
3-98 pSOSystem System Calls