al_ustr_get(3)

💖 al_ustr_get(3) 💖

okay so real talk, bestie: we're in the Library Functions Manual, and this little icon lives in the Allegro 5 API. it's giving “small function, very specific job” energy, and honestly? we respect it.

🌸 NAME 🌸

• al_ustr_get — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

int32_t al_ustr_get(const ALLEGRO_USTR *ub, int pos)

🦋 DESCRIPTION 🦋

this one returns the code point in ub that begins at byte offset pos. literally just “gimme the code point starting at this byte offset,” no cap.

• On success, it returns the code point value. slay. ✨
• If pos was out of bounds — like, past the end of the string, bestie — it returns -1. 💀
• On an error, such as an invalid byte sequence, it returns -2. not the vibe, but now you know. 😭

🎀 SEE ALSO 🎀

• al_ustr_get_next(3)
• al_ustr_prev_get(3)

---

big kiss from the Allegro reference manual footer, bestie 🫶 that's the source/version line, and this page didn't print a date, so no invented date from me 💖