al_ustr_append(3)

💅 al_ustr_append(3) 💅

okay bestie, this one is from the Library Functions Manual (the Allegro corner of it, specifically), and it’s literally the “stick one ALLEGRO_USTR onto the end of another” function. no cap. 🫶

---

🎀 NAME 🎀

al_ustr_append - Allegro 5 API

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_ustr_append(ALLEGRO_USTR *us1, const ALLEGRO_USTR *us2)

---

🌸 DESCRIPTION 🌸

okay so here’s the vibe: you take us2 and append it to the end of us1. that’s it. that’s the whole main character move. 💅

It returns true on success, false on error. so if it comes back false, something went sideways — check it, bestie. 🫶

This function can be used to append an arbitrary buffer:

ALLEGRO_USTR_INFO info;
al_ustr_append(us, al_ref_buffer(&info, buf, size));

---

🦋 SEE ALSO 🦋

• al_ustr_append_cstr(3)
• al_ustr_append_chr(3)
• al_ustr_appendf(3)
• al_ustr_vappendf(3)

---

💖 xoxo, this footer is serving Allegro reference manual / al_ustr_append(3) energy — and the original footer doesn’t print a date, so I’m not gonna invent one fr fr. catch u later! 💖