al_ustr_get_next(3)

💅 al_ustr_get_next(3) 💅

okay so bestie, this is the al_ustr_get_next(3) page from the Library Functions Manual, and it's part of the Allegro 5 API. It's a tiny one, but it's lowkey important. Let's go. ✨

---

🌸 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)

🎀 DESCRIPTION 🎀

Okay so what this icon does: it finds the code point in us that begins at the byte offset *pos, and then it advances to the next code point. Literally “get this one, then scoot forward.” 🫶

Here's the return tea, bestie:

• On success, it returns the code point value. Slay. 💖
• If pos was out of bounds (like, past the end of the string), it returns -1.
• On an error, such as an invalid byte sequence, it returns -2.
• As with al_ustr_next(3), invalid byte sequences may be skipped while advancing. That's the caveat — don't forget it. 💀

🔥 SEE ALSO 🔥

• al_ustr_get(3)
• al_ustr_prev_get(3)

---

kisses bestie 💖 — source: Allegro reference manual; version/date: this footer doesn't print a version or date, so consider this your cute undated sign-off. The page title is al_ustr_get_next(3). 🎀