WCRTOMB(3)

🌸 WCRTOMB(3) 🌸

💖 NAME 💖

okay so this is the Library Functions Manual page for wcrtomb, c16rtomb, c32rtomb — convert a wide-character code to a character (restartable). literally the whole vibe 💅

📚 LIBRARY 📚

Standard C Library (libc, -lc) — that's the library, bestie 🫶

✨ SYNOPSIS ✨

#include <wchar.h>

size_t
wcrtomb(char * restrict s, wchar_t c, mbstate_t * restrict ps);

#include <uchar.h>

size_t
c16rtomb(char * restrict s, char16_t c, mbstate_t * restrict ps);

size_t
c32rtomb(char * restrict s, char32_t c, mbstate_t * restrict ps);

🦋 DESCRIPTION 🦋

okay so the tea ☕: wcrtomb(), c16rtomb() and c32rtomb() store a multibyte sequence representing the wide character c, including any necessary shift sequences, to the character array s, storing a maximum of MB_CUR_MAX bytes. literally the glow-up from wide char to multibyte ✨

If s is NULL, these functions behave as if s pointed to an internal buffer and c was a null wide character (L'\0'). no cap, that's the rule.

The mbstate_t argument, ps, is used to keep track of the shift state. If it is NULL, these functions use an internal, static mbstate_t object, which is initialized to the initial conversion state at program startup. bestie, that static object is lowkey just always there.

As certain multibyte characters may only be represented by a series of 16-bit characters, the c16rtomb() may need to be invoked multiple times before a multibyte sequence is returned. so yeah, sometimes it's a multi-step situation 💅

🔥 RETURN VALUES 🔥

These functions return the length (in bytes) of the multibyte sequence needed to represent c, or (size_t)-1 if c is not a valid wide character code. that's the whole return story, fr fr 🫶

💀 ERRORS 💀

The wcrtomb(), c16rtomb() and c32rtomb() functions will fail if:

• [EILSEQ] — an invalid wide character code was specified.
• [EINVAL] — the conversion state is invalid.

👀 SEE ALSO 👀

• mbrtowc(3)
• multibyte(3)
• setlocale(3)
• wctomb(3)

🌈 STANDARDS 🌈

The wcrtomb(), c16rtomb() and c32rtomb() functions conform to ISO/IEC 9899:2011 (“ISO C11”). periodt. 👑

---

mwah 💋 this page is from Debian, dated May 21, 2013, and it's the WCRTOMB(3) page — bye bestie, go convert some wide chars responsibly! 🫶💅