al_fread(3)

🌸 NAME 🌸

al_fread — Allegro 5 API. This page is from the Library Functions Manual, and it’s here to explain this one tiny but iconic read function, bestie 💅

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

size_t al_fread(ALLEGRO_FILE *f, void *ptr, size_t size)

---

💅 DESCRIPTION 💅

Okay so picture this: you’ve got a file, right? al_fread() reads size bytes into the buffer pointed to by ptr, from the given file. That’s the whole vibe ✨

It returns the number of bytes actually read. If an error occurs, or the end-of-file is reached, the return value is a short byte count (or zero). No cap.

⚠️ al_fread() does not distinguish between EOF and other errors. Use al_feof(3) and al_ferror(3) to determine which occurred — fr fr, don’t just guess 🫶

---

🔥 SEE ALSO 🔥

• al_fgetc(3)
• al_fread16be(3)
• al_fread16le(3)
• al_fread32be(3)
• al_fread32le(3)

---

with love from the Allegro reference manual 💖 — source/version footer noted, and the original didn’t show a date line, so no fake date, bestie 🫶