al_utf8_encode(3alleg5)

✨ NAME ✨

okay so bestie, welcome to the al_utf8_encode(3alleg5) page — that's the manual name, and this function is part of the Allegro 5 API. She's here to encode one code point into UTF-8, and she's very good at it. 💅

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

size_t al_utf8_encode(char s[], int32_t c)

💖 DESCRIPTION 💖

Okay so picture this: you've got a code point, and you want it in UTF-8. al_utf8_encode takes that specified code point and encodes it into the buffer s. The buffer must have enough space to hold the encoding, because that encoding takes between 1 and 4 bytes — so like, size it right, bestie. 🫶

She will flat-out refuse to encode code points above 0x10FFFF. Not negotiable. No cap. 🛑

Then she returns the number of bytes written, which is the same as the number returned by al_utf8_width(3alleg5). Consistent queen behavior, honestly. ✨

🦋 SEE ALSO 🦋

• al_utf16_encode(3alleg5) — the UTF-16 sibling, if you wanna go say hi.

---

Source/version: Allegro reference manual. Page: al_utf8_encode(3alleg5). Date: the footer didn't print one, so no date, bestie 🎀. Bye and slay 💜👑