al_fread16le(3alleg5)

al_fread16le 💖

okay bestie, welcome to the Allegro 5 API — specifically the al_fread16le page, and yes it's giving "tiny function, big feelings" energy. ✨

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

int16_t al_fread16le(ALLEGRO_FILE *f)

look at her. one function, one file pointer, one little int16_t returning. iconic behavior honestly. 💅

---

🎀 DESCRIPTION 🎀

so what does she do?? she reads a 16-bit word out of the file in little-endian format — that means LSB first (least significant byte walks in first, like she owns the place). 🚶♀️💨

On success? you get the 16-bit word back. slay. 🫶

On failure? you get EOF (-1). 😭

okay but here's the tea, and it's important tea: -1 is also a valid return value. so like... you literally cannot tell "it broke" from "the data was -1" just by looking at the return. do NOT come for me, I'm just the messenger. 🙈

so instead, bestie, you gotta do the extra detective work:

• use al_feof(3alleg5) to check if the end of the file was reached prematurely 🔍
• use al_ferror(3alleg5) to check if an error occurred 🚨

periodt. no cap.

---

🌸 SEE ALSO 🌸

• al_fread16be(3alleg5) — the big-endian sibling, for when the bytes get read in the other order 🦋

---

and that's the whole page, bestie!! this was pulled straight from the Allegro reference manual for Allegro 5 (al_fread16le(3alleg5)), so go forth, read your little-endian words, and check al_feof and al_ferror like the responsible main character you are. mwah. 💜✨🎀