al_findnext(3alleg4)

✨ al_findnext — the Allegro manual, but make it cute ✨

okay bestie, welcome to the Allegro manual page for al_findnext, from the Allegro game programming library 💖

🌸 NAME 🌸

al_findnext — finds the next file in a search that was started by al_findfirst(). It's part of the Allegro game programming library, periodt. 👑

🎀 SYNOPSIS 🎀

#include <allegro.h>

int al_findnext(struct al_ffblk *info);

💅 DESCRIPTION 💅

so basically, this one grabs the next file in a search that al_findfirst() already kicked off. you can't start the party here — al_findfirst() has to go first, no cap. 🦋

here's the vibe, in code:

if (al_findfirst("*.pcx", &info, 0) != 0)
   return;

do {
   /* Do something useful here with info.name. */
} while (al_findnext(&info) == 0);

al_findclose(&info);

like, look at that loop. the way it just keeps calling al_findnext(&info) until it stops returning 0? iconic behaviour honestly. 🔥

⭐ RETURN VALUE ⭐

• returns zero if a match is found 🥳
• returns non-zero if none is found, or if an error occurred
• and in that error case specifically, it sets errno accordingly — so go check it, bestie 💀

👑 SEE ALSO 👑

• al_findfirst(3alleg4)
• al_findclose(3alleg4)

mwah, that's the whole page 🫶 Allegro, version 4.4.3 — catch you on the next one, bestie, stay slaying those file searches 💜✨🎀