al_ustr_find_chr(3alleg5)

✨ al_ustr_find_chr ✨

okay bestie, welcome to the Allegro 5 API 💖 this is the al_ustr_find_chr page, and yes it's exactly as iconic as it sounds. we're finding a character in a string. that's the whole vibe. let's go 🦋

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

int al_ustr_find_chr(const ALLEGRO_USTR *us, int start_pos, int32_t c)

like, that's the whole thing. one function. one glow-up. 💅

---

💫 DESCRIPTION 💫

so here's the tea: you pass in us, start_pos, and c, and this function goes searching for the encoding of code point c inside us — starting at byte offset start_pos, and yes, that start point is inclusive (so the byte sitting right at start_pos counts too, no skipping, no gatekeeping 🫶).

then it just... tells you where it found it.

• found it? slay 🎀 you get back the position where it's chillin'.
• didn't find it? -1. that's it. that's the answer. it's not there, bestie 😭

no cap, that's the whole function. short, sweet, does exactly one job and does it well. main character energy honestly 👑

---

👀 SEE ALSO 👀

• al_ustr_rfind_chr(3alleg5) — the same search but from the other direction, if you're feeling backwards today 🔄

---

💜 SIGN-OFF 💜

this lil masterpiece lives in the Allegro reference manual (page: al_ustr_find_chr(3alleg5)) — so yeah, that's the source, that's the version, that's the whole lineage. go forth and find your characters, bestie. periodt 💅✨🌈