al_ref_ustr(3)

okay bestie, welcome to al_ref_ustr(3) from the Library Functions Manual — Allegro 5 API energy, let’s go 💅✨

🎀 NAME 🎀

• al_ref_ustr — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

const ALLEGRO_USTR *al_ref_ustr(ALLEGRO_USTR_INFO *info, const ALLEGRO_USTR *us,
   int start_pos, int end_pos)

🌸 DESCRIPTION 🌸

So this one creates a read-only string that references the storage of another ALLEGRO_USTR(3) string. Iconic, low-key efficient behavior. 💖

The information about the string — like its size — is stored in the structure pointed to by the info parameter. The new string will not have any other storage allocated of its own, so if you allocate the info structure on the stack, then no explicit “free” operation is required. Slay, no cleanup drama. 🎀

The referenced interval is [start_pos, end_pos). Both are byte offsets. Byte girlies, this is your moment 🦋

⚠️ bestie, this is important: the string is valid until the underlying string is modified or destroyed. Do not ignore this vibe check 😭

If you need a range of code-points instead of bytes, use al_ustr_offset(3) to find the byte offsets. iykyk 💅

🦋 SEE ALSO 🦋

• al_ref_cstr(3)
• al_ref_buffer(3)

---

mwah 💋 — signed off from the Allegro reference manual; the footer didn’t give a version or date, just the page name again, so that’s the whole metadata story, bestie 🫶✨