al_ustr_assign_substr(3)

💖 al_ustr_assign_substr(3) 💖

okay bestie, welcome to the Allegro 5 API — this one lives in the Library Functions Manual, and it's genuinely one of the cutest little string functions out there, no cap ✨

---

🌸 NAME 🌸

al_ustr_assign_substr — Allegro 5 API 🫶

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_ustr_assign_substr(ALLEGRO_USTR *us1, const ALLEGRO_USTR *us2,
   int start_pos, int end_pos)

like, that's the whole vibe check right there 👑

---

🦋 DESCRIPTION 🦋

so here's the tea 🍓: this function overwrites the string us1 with the contents of us2 — but only the slice of us2 in the byte interval [start_pos, end_pos). it's giving "cut and paste but make it bytes" 💅

note the interval, bestie: start_pos is included, end_pos is not — classic half-open situation, iykyk 🔥

and the end points? they get clamped to the bounds of us2 — so if you go a little feral with your numbers, it just politely clamps instead of exploding 💀 (still, maybe don't test fate)

usually you'll first have to use al_ustr_offset(3) to find the byte offsets — that's your little map to the territory, fr fr 🧚

returns true on success, false on error 😭

---

🎀 SEE ALSO 🎀

• al_ustr_assign(3)
• al_ustr_assign_cstr(3)

---

lowkey the whole point: slice + overwrite + clamp. periodt 💜

---

okay that's the whole page bestie, you ate that reading session 👑 this was the Allegro reference manual, al_ustr_assign_substr(3), mwah 💋