al_fgets(3)

💖 NAME 💖

al_fgets — Allegro 5 API, bestie. This page is from the Library Functions Manual, and it’s the al_fgets(3) moment — slay 💅.

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

char *al_fgets(ALLEGRO_FILE *f, char * const buf, size_t max)

🌸 DESCRIPTION 🌸

Okay so al_fgets reads a string of bytes into the buffer you gave it, and it keeps going until it hits a newline or end-of-file. The line terminator(s), if any, are included in the returned string — yes, they come along for the ride. It reads a maximum of max-1 bytes, because one byte is reserved for a NUL terminator. boundaries, bestie.

Parameters:

• f — file to read from
• buf — buffer to fill
• max — maximum size of buffer

It returns the pointer to buf on success 💖. It returns NULL if an error occurred or if the end of file was reached without reading any bytes 😭.

See al_fopen(3) about translations of end-of-line characters. iykyk.

🦋 SEE ALSO 🦋

• al_fget_ustr(3)

---

💌 cute sign-off: that’s the whole vibe from the Allegro reference manual, page al_fgets(3). The date slot is not printed in this footer, so we’re not inventing one — bye bestie 🫶✨