Defined in header
int mbtowc( wchar_t *pwc, const char *s, size_t n )
int mbtowc( wchar_t *restrict pwc, const char *restrict s, size_t n )
Converts a multibyte character whose first byte is pointed to by
s to a wide character, written to
pwc is not null.
s is a null pointer, resets the global conversion state and determines whether shift sequences are used.
Each call to
mbtowc updates the internal global conversion state (a static object of type mbstate_t, only known to this function). If the multibyte encoding uses shift states, care must be taken to avoid backtracking or multiple scans. In any case, multiple threads should not call
mbtowc without synchronization: mbrtowc may be used instead.
|pwc||-||pointer to the wide character for output|
|s||-||pointer to the multibyte character|
|n||-||limit on the number of bytes in s that can be examined|
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 '\0'.
s is a null pointer, resets its internal conversion state to represent the initial shift state and returns 0 if the current multibyte encoding is not state-dependent (does not use shift sequences) or a non-zero value if the current multibyte encoding is state-dependent (uses shift sequences).
|This section is incomplete|
Reason: no example
| converts the next multibyte character to wide character, given state |
| returns the number of bytes in the next multibyte character |
C++ documentation for mbtowc