---

10.68.5 mbrtoc16 ¶

ISO C23 specification:
https://www.open-std.org/jtc1/sc22/wg14/www/docs/n3220.pdf section 7.30.1.3.

POSIX specification:
https://pubs.opengroup.org/onlinepubs/9799919799/functions/mbrtoc16.html

Gnulib module: mbrtoc16

Portability problems fixed by Gnulib:

• This function is missing on most non-glibc platforms: glibc 2.15, macOS 14, FreeBSD 6.4, NetBSD 10.0, OpenBSD 7.3, Minix 3.1.8, AIX 7.1, HP-UX 11.31, Solaris 11.3, Cygwin 3.4.x, mingw, MSVC 9, Android 4.4.
• This function may crash when the first argument is NULL on some platforms: glibc 2.36.
• In the C or POSIX locales, this function can return (size_t) -1 and set errno to EILSEQ: glibc 2.36.
• This function returns 0 instead of (size_t) -2 when the input is empty: glibc 2.19, Android 11.
• This function returns the total number of bytes that make up the multibyte character, not the number of bytes that were needed to complete the multibyte character, on some platforms: mingw.
• This function returns (size_t) -3 instead of a byte count when it has stored a high surrogate, and returns a byte count instead of (size_t) -3 when it has stored a low surrogate, on some platforms: Android.
• This function does not recognize multibyte sequences that mbrtowc recognizes on some platforms: FreeBSD 13.2, Solaris 11.4, MSVC 14.

Portability problems not fixed by Gnulib:

• After mbrtoc16 returns a char16_t value, mbsinit cannot be used to determine whether the function is ready to return another char16_t value. To do so, instead call mbrtoc16 again, with an appropriately incremented const char * argument and an appropriately decremented size_t argument.