al_ref_buffer(3)

💖 NAME 💖

Okay so this page lives in the Library Functions Manual, and it’s serving al_ref_buffer — Allegro 5 API realness ✨

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

const ALLEGRO_USTR *al_ref_buffer(ALLEGRO_USTR_INFO *info, const char *s, size_t size)

🦋 DESCRIPTION 🦋

So al_ref_buffer creates a string that references the storage of an underlying buffer. The size of the buffer is given in bytes — yes bestie, bytes, write that down 💅

You can use it to reference only part of a string or an arbitrary region of memory. Lowkey iconic.

The string is valid while the underlying memory buffer is valid. That’s the whole vibe check, bestie — when the buffer’s gone, the string is not okay 😭

🎀 SEE ALSO 🎀

• al_ref_cstr(3)
• al_ref_ustr(3)

---

Cute sign-off: this one’s from the Allegro reference manual 🫶 and the footer has no date, so I’m not inventing one — periodt 💜