al_read_directory(3)

🌸 NAME 🌸

okay so this page is al_read_directory(3) — manual name right there, bestie — and it’s serving the Allegro 5 API function al_read_directory. lowkey iconic, highkey useful 💅.

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

ALLEGRO_FS_ENTRY *al_read_directory(ALLEGRO_FS_ENTRY *e)

---

💖 DESCRIPTION 💖

So the way this works: it reads the next directory item and returns a filesystem entry for it. fr fr, that’s the whole main character move 💫.

• It returns NULL if there are no more entries or if an error occurs.
• Call al_destroy_fs_entry(3) on the returned entry when you’re done with it — no leaving your FS_ENTRYs lying around, bestie 🧹✨.

Also important: this function will ignore any files or directories named . or .. which may exist on certain platforms and may signify the current and the parent directory. so yeah, those get the silent treatment 🙈💅.

---

🦋 SEE ALSO 🦋

• al_open_directory(3)
• al_close_directory(3)

---

mwah 💋 — this page comes from the Allegro reference manual (that’s the source/version vibe), and the footer rocks the al_read_directory(3) title tag. The original footer didn’t give a date, so we’re not inventing one — periodt 🌈👑.