utf8towc()

Convert a UTF-8 character to a wide-character code

Synopsis:

int utf8towc( wchar_t *pwc,
              const char *s,
              size_t n );

Arguments:

pwc
A pointer to a location where utf8towc() stores the wide-character representation of s.
s
A pointer to a UTF-8 character.
n
The maximum number of bytes to convert.

Library:

ph

Description:

The utf8towc() function converts a single UTF-8 character pointed to by s into a wide-character code pointed to by pwc, to a maximum of n bytes.

This function is similar to mbtowc(), except:

Returns:

0
The s argument points to the null character.
> 0
The number of bytes that comprise the multibyte character, to a maximum of UTF8_LEN_MAX (if the next n or fewer bytes form a valid multibyte character).
-1
The next n bytes don't form a valid (complete) multibyte character.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

wctoutf8()

Unicode Multilingual Support in the Photon Programmer's Guide

mbtowc() in the QNX Neutrino Library Reference