al_ustr_offset(3alleg5)

✨ al_ustr_offset ✨

okay bestie, so this one lives in the Allegro 5 API manual — it's al_ustr_offset(3alleg5), and she's a little function that tells you where a character actually sits inside your string 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

int al_ustr_offset(const ALLEGRO_USTR *us, int index)

---

🦋 DESCRIPTION 🦋

So basically, al_ustr_offset hands you the byte offset — counted from the very start of the string — of the code point that's chillin' at the index you asked for. 🎀

• Pass in a zero for index and you get back the first character of the string. simple as that, no notes.
• Pass in a negative index and it counts backward from the end instead. so an index of -1 gives you the offset to the last code point. yes queen, backwards indexing, we love to see it. 🫶

And if you get a little too eager and your index goes past the end of the string? No crash, no drama — it just returns the offset of the end of the string. polite of her honestly. 😌

---

💖 SEE ALSO 💖

• al_ustr_length(3alleg5)

---

and that's the whole vibe, bestie — go forth and index responsibly 🌈 this was al_ustr_offset(3alleg5) from the Allegro reference manual, mwah 💋 🎀