al_ustr_get_next(3alleg5)

💖 al_ustr_get_next(3alleg5) 💖

okay so bestie, welcome to the Allegro 5 API ✨ this one lives in the al_ustr_get_next(3alleg5) girlies' club and she is so useful. come sit, we're gonna read code points together 🎀

---

🌸 NAME 🌸

al_ustr_get_next — Allegro 5 API 💅

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

int32_t al_ustr_get_next(const ALLEGRO_USTR *us, int *pos)

like. look at her. two args, one int32_t return, zero drama 🦋

---

👑 DESCRIPTION 👑

okay so what she does is: she finds the code point in us that begins at byte offset *pos, and then she advances you over to the next code point. literally a glow-up for your pointer 💫

here's the tea on what you get back, no cap:

• on success — she returns the code point value 🥳 iconic, we love her
• if pos was out of bounds (like, e.g. past the end of the string) — she returns -1 😭
• on an error, such as an invalid byte sequence — she returns -2 💀

also, fr fr, just like al_ustr_next(3alleg5) does: invalid byte sequences may be skipped while advancing. so don't be shocked when your position hops further than you expected 🫶

---

🌈 SEE ALSO 🌈

• al_ustr_get(3alleg5)
• al_ustr_prev_get(3alleg5)

---

Allegro reference manual 🎀 version 3alleg5 — mwah, that's the whole page bestie, you ate, go write some string-walking code, periodt 💅✨🦋