al_fget_ustr(3)

okay so bestie, welcome to the al_fget_ustr(3) page from the Allegro 5 API manual 💖 — that’s the manual name right there, folded in all cute, no header-line copy-paste happening here, periodt ✨

🌸 NAME 🌸

al_fget_ustr — Allegro 5 API 💅

🦋 SYNOPSIS 🦋

okay, the exact spells you need are:

#include <allegro5/allegro.h>

ALLEGRO_USTR *al_fget_ustr(ALLEGRO_FILE *f)

🔥 DESCRIPTION 🔥

So al_fget_ustr reads a string of bytes, and it stops when it hits a newline or end-of-file 🌈. The line terminator(s), if any, are included in the returned string — yes, they’re coming with you, no cap 🎀.

On success it returns a pointer to a new ALLEGRO_USTR structure. This must be freed eventually with al_ustr_free(3) — don’t leave it lingering, bestie 🫶. It returns NULL if an error occurred or if the end of file was reached without reading any bytes 😭.

Also, for the tea on translations of end-of-line characters, see al_fopen(3) 👀.

⭐ SEE ALSO ⭐

• al_fgetc(3)
• al_fgets(3)

---

and that’s the whole vibe: this was the Allegro reference manual, al_fget_ustr(3) page — the footer has no date listed, so I’m not inventing one, fr fr 💜