Converts a narrow multibyte character to UTF-8 encoding.

Ifs is not a null pointer, inspects at mostn bytes of the multibyte character string, beginning with the byte pointed to bys to determine the number of bytes necessary to complete the next multibyte character (including any shift sequences). If the function determines that the next multibyte character ins is complete and valid, converts it to UTF-8 and stores the first UTF-8 code unit in*pc8 (ifpc8 is not null).

If UTF-8 encoding of the multibyte character in*s consists of more than one UTF-8 code unit, then after the first call to this function,*ps is updated in such a way that the next call tombrtoc8 will write out the additional UTF-8 code units, without considering*s.

Ifs is a null pointer, the values ofn andpc8 are ignored and the call is equivalent tostd::mbrtoc8(nullptr,"",1, ps).

If UTF-8 code unit produced isu8'\0', the conversion state*ps represents the initial shift state.

The multibyte encoding used by this function is specified by the currently active C locale.

[edit]Parameters

[edit]Return value

The first of the following that applies:

• ​0​ if the character converted froms (and stored in*pc8 if non-null) was the null character.
• the number of bytes[1...n] of the multibyte character successfully converted froms.
• static_cast<std::size_t>(-3) if the next UTF-8 code unit from a character whose encoding consists of multiple code units has now been written to*pc8. No bytes are processed from the input in this case.
• static_cast<std::size_t>(-2) if the nextn bytes constitute an incomplete, but so far valid, multibyte character. Nothing is written to*pc8.
• static_cast<std::size_t>(-1) if encoding error occurs. Nothing is written to*pc8, the valueEILSEQ is stored inerrno and the value of*ps is unspecified.

[edit]Example

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文