io_readfile(3)

💖 io_readfile(3) 💖

okay bestie, welcome to the Library Functions Manual corner of the libowfat universe 🌈 this one's short, sweet, and honestly kinda iconic — it's the lil guy that gets you a shiny new file descriptor pointed at a file on disk. no cap.

---

✨ NAME ✨

io_readfile — open a file for reading 🫶

---

🌸 SYNTAX 🌸

#include <libowfat/io.h>

int io_readfile(int64* d,const char* filename);

like, that's it. two args. one header. we love a minimal queen 💅

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — io_readfile sets d to the number of a brand new descriptor that reads from the disk file named filename, and then it returns 1. that's the good ending. main character energy fr fr ✨

if something goes wrong though? 😭 it sets errno to indicate the error, and returns 0. and listen — when it fails, it does not create a new descriptor, and it does not touch d. so d stays exactly how you left it. no sneaky edits, no surprise side quests. she's respectful like that 💜

ngl this is the kind of function where you always check the return value. 1 = slay, 0 = check errno and cry a lil. 🙈

---

👑 SEE ALSO 👑

• io_createfile(3)
• io_appendfile(3)
• io_readwritefile(3)

go read those too, bestie, the whole squad is valid 🔥

---

sign-off time 🎀 this lil page lives in the Library Functions Manual, it's all about io_readfile(3), and the footer at the very bottom just says io_readfile(3) right back atcha — that's the vibe, that's the brand, periodt 💅✨🦋