std::mbtowc (3) Linux Manual Page

NAME

std::mbtowc – std::mbtowc

Synopsis

Defined in header <cstdlib>
int mbtowc( wchar_t* pwc, const char* s, std::size_t n );

Converts a multibyte character whose first byte is pointed to by s to a wide character, written to *pwc if pwc is not null.
If s is a null pointer, resets the global conversion state and determines whether shift sequences are used.

Parameters

s – pointer to the multibyte character
n – limit on the number of bytes in s that can be examined
pwc – pointer to the wide character for output

Return value

If s is not a null pointer, returns the number of bytes that are contained in the multibyte character or -1 if the first bytes pointed to by s do not form a valid multibyte character or 0 if s is pointing at the null charcter ‘