al_findfirst(3)

💖 NAME 💖

al_findfirst — the low-level function for searching files, straight out of the Allegro game programming library bestie 🎀

---

✨ SYNOPSIS ✨

#include <allegro.h>

int al_findfirst(const char *pattern, struct al_ffblk *info, int attrib);

---

🌸 DESCRIPTION 🌸

okay so al_findfirst is the low-level girlie that goes hunting for files for you 🔥 She finds the first file that matches the wildcard specification you hand her, plus the file attributes you asked for (see above, iykyk). All the tea she finds about that file (if there even is one, no cap) gets dropped into the al_ffblk structure — and yes, you have to provide that structure yourself, she's not doing that for you 💅

The al_ffblk structure is giving:

struct al_ffblk
{
   int attrib;       - actual attributes of the file found
   time_t time;      - modification time of file
   char name[512];   - name of file
};

There's some other stuff in the structure as well, but it is there for internal use only 🙈 like don't touch it, it's not for you.

Example time, periodt:

struct al_ffblk info;

if (al_findfirst("*.pcx", &info, FA_ALL) != 0) {
   /* Tell user there are no PCX files. */
   return;
}

---

⭐ RETURN VALUE ⭐

She returns non-zero if no match is found 😭 or if an error occurred — and in that error case she sets errno accordingly, so check it, bestie.

She returns zero if a match IS found 🎉 and lowkey she allocates some memory for internal use inside that structure while she's at it.

🚨 THE IMPORTANT PART 🚨 because she grabbed memory, you have to close your search when you are finished or you're gonna have memory leaks in your program fr fr. don't be that girlie.

---

🦋 SEE ALSO 🦋

• al_findnext(3)
• al_findclose(3)
• al_ffblk_get_size(3)

---

k bye ily, this was Allegro version 4.4.3 energy 👑✨ go close your searches, mwah 💖🎀