al_ustr_replace_range(3)

✨ al_ustr_replace_range(3) — Allegro 5 API ✨

okay bestie, so this one is from the Allegro 5 API manual and it's genuinely such a useful little function, like the string-surgery icon that it is 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

bool al_ustr_replace_range(ALLEGRO_USTR *us1, int start_pos1, int end_pos1,
   const ALLEGRO_USTR *us2)

---

💖 DESCRIPTION 💖

okay so picture this: you've got a string us1 and you want to swap out a chunk of it with the entire contents of another string us2. that's literally the whole vibe of this function 🫶

It replaces the part of us1 sitting in the byte interval [start_pos1, end_pos1) with the contents of us2. note the bracket situation — inclusive on the left, exclusive on the right, iykyk.

rule check: start_pos1 cannot be less than 0. no negative shenanigans allowed, periodt 🙈

and here's the fun part — if start_pos1 is past the end of us1, then the space between the end of the string and start_pos1 gets padded with NUL ('\0') bytes. it's giving "stretch to fit" energy ✨

need to find the byte offsets? use al_ustr_offset(3) — that's your girl for that 💜

Returns true on success, false on error. simple as that 💀

---

🦋 SEE ALSO 🦋

• al_ustr_set_chr(3)

---

okay that's the whole page bestie, you ate that 💅✨🎀

this was the Allegro reference manual 💖 — the al_ustr_replace_range(3) page, no version number or date listed on it, so that's all we got 🫶 slay 🌸