HP C/iX Library Reference Manual (30026-90004)

Chapter 5 251

HP C/iX Library Function Descriptions

mbstowcs

Converts a sequence of multibyte characters in a null-terminated string to a sequence of

wide character codes.

Syntax

#include <stdlib.h>

size_t mbstowcs(wchar_t *

pwcs

, const char *

, size_t

);

Parameters

pwcs

A pointer to an array of wide characters where the converted wide

character codes are stored.

A pointer to a sequence of multibyte characters to be converted.

An expression indicating the maximum number of codes to be stored into

the array pointed to by

pwcs

Return Values

x The number of array elements modiﬁed, not including a terminating zero.

If x =

, the array is not zero-terminated.

size_t(-1) Invalid multibyte character found.

Description

The multibyte characters from the array pointed to by

are converted to wide character

codes and stored into the array pointed to by

pwcs

. No more than

elements will be

modiﬁed in the array pointed to by

pwcs