al_utf8_encode(3)

al_utf8_encode(3) 💅✨

Welcome to the Library Functions Manual corner of the Allegro 5 API, bestie — this is al_utf8_encode(3), and she is lowkey iconic.

✨ NAME ✨

al_utf8_encode — Allegro 5 API. It’s the function for encoding a code point into UTF-8, and yes, she ate. 💖

💖 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 c, and you want it living its best UTF-8 life inside the buffer s. That’s the whole gig. 🌸

The buffer must have enough space to hold the encoding, which takes between 1 and 4 bytes. So don’t be out here handing her a tiny buffer — that’s not the vibe check you want. 😭

This routine will refuse to encode code points above 0x10FFFF. That’s the line, bestie, and she will not cross it. Periodt. 💅

It returns the number of bytes written, which is literally the same as that returned by al_utf8_width(3). Slay. ✨

👑 SEE ALSO 👑

• al_utf16_encode(3) — the UTF-16 sibling, go say hi. 🫶

---

source + version: Allegro reference manual; page: al_utf8_encode(3) 💖 date: not printed on this page, and we are not inventing one, no cap. 🎀✨