al_ustr_prev_get(3)

💖 al_ustr_prev_get(3) 💖

okay bestie, we're in the Library Functions Manual and this little icon is an Allegro 5 API page. no cap, it's giving “tiny string utility with big main character energy.” 🦋

🌸 NAME 🌸

• al_ustr_prev_get — Allegro 5 API 💅

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

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

🦋 DESCRIPTION 🦋

okay so here's the tea: al_ustr_prev_get finds the beginning of a code point before the byte offset at *pos, then returns it. 🫶 it's literally doing a pre-increment, so don't get it twisted, bestie. ✨

On success? it returns the code point value. iconic. 💖

If pos was out of bounds (say, past the end of the string), you get -1 back. 😭

On an error — like an invalid byte sequence — you get -2. 💀

And just like with al_ustr_prev(3), invalid byte sequences may be skipped while advancing. so yeah, the advance can vibe right past them; that's the heads-up, fr fr. 🌈

🎀 SEE ALSO 🎀

• al_ustr_get_next(3) — the next little function in your string journey, go bestie 🦋

xoxo, the Allegro reference manual 🌈 — that's the source/version tea; the footer didn't hand us a date, so we're not inventing one, periodt 💅🎀