file_size_ex(3alleg4)

💖 file_size_ex — the Allegro manual, bestie edition 💖

okay so real talk, this one lives in the Allegro game programming library manual. 3alleg4, section 3. yes we're doing manpage lore now, it's giving study group but make it cute. 🎀

✨ NAME ✨

file_size_ex — returns the size of a file in bytes. Allegro game programming library. that's it, that's the whole job, and she does it flawlessly. 👑

✨ SYNOPSIS ✨

#include <allegro.h>

uint64_t file_size_ex(const char *filename);

look at her. one include, one function, one const char *filename. clean. 🦋

✨ DESCRIPTION ✨

so basically: file_size_ex returns the size of a file, in bytes. that's the tea. ☕

you hand her a filename, she hands you back a uint64_t and you go about your day.

but bestie, listen, there's a plot twist 🫶 — if the file does not exist, or if an error occurs, she doesn't yell at you, she just returns zero and quietly stores the system error code in errno. so like. if you get a 0 back, that's your cue to go check errno before you assume the file is just empty. iykyk. 😭

⚠️ note: a return value of zero does not automatically mean "empty file", it can also mean "file doesn't exist or something went wrong". the error code is in errno. don't get caught out, bestie, the vibes will betray you. 💀

✨ SEE ALSO ✨

• file_exists(3alleg4) — the "does this even exist" check, do this first ngl 🌸
• file_time(3alleg4) — for when you wanna know when, not how big 🕐
• expackf(3alleg4) — another one from the family, go read it 💜

and that's the whole page!! main character energy from a function that just counts bytes. obsessed, honestly. 🌈

Allegro, version 4.4.3 — mwah, love that for us. signing off from the file_size_ex(3alleg4) corner of the Allegro manual 💅✨🎀🦋