al_ustr_append_chr(3)

💖 al_ustr_append_chr(3) — the Allegro 5 API one 💖

okay so bestie, this is a page from the Allegro 5 API manual — yes, the whole <allegro5/...> fam — and it's literally one function long. tiny page, big slay 🎀

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

size_t al_ustr_append_chr(ALLEGRO_USTR *us, int32_t c)

that's it. that's the whole vibe check. 🦋

---

🌸 DESCRIPTION 🌸

so what it does is: it appends a code point to the end of us. like, you got your ALLEGRO_USTR *us hanging out, and this function just… sticks c on the end of it. one code point. that's the whole job. 💅

and the return value? it returns the number of bytes added — ✨ bytes ✨, not characters, important distinction bestie, a code point is not always one byte, iykyk — or 0 on error. so if you get a 0 back, something went wrong and you should probably look at that. 😭

ngl it is genuinely that simple. no hidden options, no gotchas listed here. sometimes the manual page is just short and sweet and that's iconic of it.

---

🔥 SEE ALSO 🔥

• al_ustr_append(3) — the bigger, more general sibling. go say hi. 🫶

---

and that's the whole page, bestie! 🧚 source: the Allegro reference manual, and the page itself is al_ustr_append_chr(3) in case you forgot already (no judgement, I literally just told you). mwah 💜✨🎀