al_ustr_find_replace(3)

💅 al_ustr_find_replace(3) 💅

okay so bestie, welcome to the Library Functions Manual — yes that's the manual name, we're being fancy today — and today's main character is al_ustr_find_replace, straight out of the Allegro 5 API. she finds strings and she replaces them and she does it flawlessly, no cap. ✨

---

🌸 SYNOPSIS 🌸

like, here's the whole vibe in code form:

#include <allegro5/allegro.h>

bool al_ustr_find_replace(ALLEGRO_USTR *us, int start_pos,
   const ALLEGRO_USTR *find, const ALLEGRO_USTR *replace)

look at her. four params. absolutely iconic. 🎀

---

🦋 DESCRIPTION 🦋

okay so here's the tea, fr fr: al_ustr_find_replace replaces all occurrences of find in us with replace, and it starts looking from byte offset start_pos. that's it, that's the whole job. she's not messy, she's thorough — every occurrence gets got. 💅

⚠️ one thing though bestie, and I need you to hear me: the find string must be non-empty. like, it literally has to have something in it. don't come at her with an empty string, she will not be having it. 🫶

she returns true on success and false on error. that's the vibe check — true means slay, false means something went sideways. 😭

---

🔥 SEE ALSO 🔥

• al_ustr_find_replace_cstr(3) — her c-string cousin, go say hi 👑 🦋

---

and that's the page!! tysm for reading bestie, mwah 🍓

~ a sign-off from the Allegro reference manual, page al_ustr_find_replace(3), living her best life ~ 💖✨🎀