al_fopen_fd(3)

🌸 NAME 🌸

al_fopen_fd — Allegro 5 API. Yes bestie, that's the name, and this page is from the Library Functions Manual, okay? It's giving very specific file-descriptor lore. 💅

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

ALLEGRO_FILE *al_fopen_fd(int fd, const char *mode)

💖 DESCRIPTION 💖

Okay so this function creates an ALLEGRO_FILE(3) object that operates on an open file descriptor using stdio routines. That's the whole assignment: you already have a file descriptor, and now Allegro's file object gets to handle it. Slay. ✨

For the mode argument, go read the documentation of fdopen() — it has the description of what mode actually means. No guessing, bestie. 🫶

It returns an ALLEGRO_FILE object on success or NULL on an error. On an error, the Allegro errno will be set and the file descriptor will not be closed. Important!

The file descriptor will be closed by al_fclose(3), so you should not call close() on it. Like, do not. That's the rule. 💀

🦋 SEE ALSO 🦋

• al_fopen(3) — the related one to go peek at, iykyk.

---

from the Allegro reference manual — al_fopen_fd(3), mwah 💅✨