al_ustr_next(3)

✨ al_ustr_next(3) ✨

okay bestie, so this one is from the Allegro 5 API — it lives in the Library Functions Manual, and honestly? she's a little byte-hopping icon and we're gonna learn her together 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_ustr_next(const ALLEGRO_USTR *us, int *pos)

like, that's the whole vibe. two args, one bool back. easy 🎀

---

🦋 DESCRIPTION 🦋

so the whole point of al_ustr_next is: find the byte offset of the next code point in the string, starting from wherever *pos is pointing. and here's the thing — *pos does not have to be sitting at the beginning of a code point. she's flexible like that, no cap 💖

if it works, you get true back, and the value that pos points to gets updated to that found offset. slay. ✨

if it doesn't work — meaning *pos was already at the end of the string — you get false, and *pos is left completely unmodified. untouched. not a single byte moved 🙈

⚠️ okay this part is important, don't skip it: this function just looks for an appropriate byte. it does not check whether the found offset is actually the beginning of a valid code point. so if you're out here working with possibly invalid UTF-8 strings, be aware it could skip right over some invalid bytes. fr fr, read that twice 😭

---

🔥 SEE ALSO 🔥

• al_ustr_prev(3) — the other direction, bestie, go check her out 🫶

---

mwah 💜 that's the whole page, and yes, this is the Allegro reference manual — that's the source/version situation, that's the whole footer vibe, we keep it cute and we keep it accurate ✨🎀🦋