io_createfile(3)

✨ io_createfile(3) ✨

okay bestie, gather round 💖 this is io_createfile, straight out of the Library Functions Manual, and it does exactly one (1) thing and does it iconically: it makes you a file. let's get into it 🫶

---

🌸 NAME 🌸

io_createfile — create a file ✨

---

🎀 SYNTAX 🎀

#include <libowfat/io.h>

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

no cap, that's the whole vibe check right there 💅

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie 🍓 io_createfile sets d to the number of a brand new descriptor that's writing to the disk file named filename, and then it returns 1. slay. 🎉

• if filename already existed? it gets truncated to length 0 — like, wiped, empty, gone, periodt 💀
• if it didn't exist? it gets created, with mode 0600 👑

and if something goes wrong 😭 io_createfile sets errno to indicate the error and returns 0. it does not create a new descriptor, and it does not touch d. main character boundaries, honestly 🙈

⚠️ okay but fr fr — even when it fails, it may have truncated or created the file. so like, the file could lowkey already be changed even though you got a 0 back. be aware, bestie, that's the fine print and it's important 💅

---

🌈 SEE ALSO 🌈

• io_readfile(3)
• io_appendfile(3)
• io_readwritefile(3)

the whole file-io friend group, obsessed 🫶

---

that's the page, bestie 💜 it's from the Library Functions Manual, and yeah, it's just called io_createfile(3) — go forth and create files responsibly, mwah 😭✨💖