al_feof(3)

🦋 NAME 🦋

Okay bestie, meet al_feof from the Library Functions Manual — it’s literally the Allegro 5 API page, and the title is al_feof(3), no cap.

• al_feof — Allegro 5 API

✨ SYNOPSIS ✨

Here’s the exact spell, bestie:

#include <allegro5/allegro.h>

bool al_feof(ALLEGRO_FILE *f)

💅 DESCRIPTION 💅

Returns true if the end-of-file indicator has been set on the file — i.e. we have attempted to read past the end of the file. Periodt. 💖

This does not return true if we simply are at the end of the file. The following code correctly reads two bytes, even when the file contains exactly two bytes:

int b1 = al_fgetc(f);
int b2 = al_fgetc(f);
if (al_feof(f)) {
   /* At least one byte was unsuccessfully read. */
   report_error();
}

🫶 Tiny vibe check: “at the end” and “attempted to read past the end” are not the same thing, bestie — that’s the whole plot twist, fr fr.

🌈 SEE ALSO 🌈

Go give these cuties a read too:

• al_ferror(3)
• al_fclearerr(3)

---

Signed off by the Allegro reference manual — that’s the source/version bit, and the original footer doesn’t print a separate date, bestie 💜 al_feof(3) out. 🎀