al_ftell(3alleg5)

💖 al_ftell — Allegro 5 API 💖

okay bestie, pull up a chair, we're in the Allegro 5 API manual and today's main character is al_ftell (yes, that's the 3alleg5 girlies, you know the vibe) 🦋

---

✨ NAME ✨

al_ftell — literally just Allegro 5 API things, no cap 🎀

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

int64_t al_ftell(ALLEGRO_FILE *f)

look at her. short. iconic. does exactly what it says on the tin 💅

---

🫶 DESCRIPTION 🫶

so like, al_ftell tells you where you're currently at in the file f — the current position, bestie, that's it, that's the whole job ✨

it hands you back the position... or -1 if something went wrong 😭 and when it does go wrong, errno gets set to tell you what the actual error was. so if you're staring at a -1 like 👁️👄👁️, go check errno (or better yet, al_get_errno).

real talk though: on some platforms this function may not support large files. so if you're out here with a big ol' file and things look sus, that's probably why. not every platform is built the same, and that's just the tea 🍵

---

👑 SEE ALSO 👑

• al_fseek(3alleg5) — the partner in crime, moves the position around 🕺
• al_get_errno(3alleg5) — for when you need the receipts on what went wrong 💀

---

and that's the whole page, bestie, you ate that 🌈 source is the Allegro reference manual, and this little al_ftell(3alleg5) moment lives right there in it. go forth and seek (or, y'know, tell) 💜✨