ALLEGRO_FOR_E..._ENTRY_RESULT(3alleg5)

πŸ“¦
version 5.2.11.3 Β· 4 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ ALLEGRO_FOR_EACH_FS_ENTRY_RESULT ✨

okay bestie, welcome to the Allegro reference manual πŸ’– this one is a lil baby page but it's important, fr fr. it's all about the enum that tells al_for_each_fs_entry what to do next. sit down, grab a strawberry πŸ“, let's go.


🌸 NAME 🌸

ALLEGRO_FOR_EACH_FS_ENTRY_RESULT β€” the Allegro 5 API thingie that's literally just an enum of vibes for your filesystem-walking callbacks πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

#include <allegro5/allegro.h>

typedef enum ALLEGRO_FOR_EACH_FS_ENTRY_RESULT {

yes bestie, that's the whole synopsis, it just cuts off like that, the manpage said so, no cap 🫢


πŸ¦‹ DESCRIPTION πŸ¦‹

so like. these are the return values your callbacks hand back when you're using al_for_each_fs_entry(3alleg5), and also the values that function itself can give you back. it's giving "control flow but make it cute" ✨

here's the whole roster, every single one, no skipping:

  • ALLEGRO_FOR_EACH_FS_ENTRY_ERROR β€” oopsie, an error happened 😭 something went wrong, that's the whole story.
  • ALLEGRO_FOR_EACH_FS_ENTRY_OK β€” the main character response πŸ‘‘ keep going like normal, and yes, do recurse down into directories. live your truth.
  • ALLEGRO_FOR_EACH_FS_ENTRY_SKIP β€” keep going, but do NOT recursively descend. you're skipping the depth, not the loop, iykyk πŸ™ˆ
  • ALLEGRO_FOR_EACH_FS_ENTRY_STOP β€” that's a wrap, stop iterating and return. periodt πŸ’…
ngl, OK vs SKIP is the classic bestie trap β€” one goes deeper, one stays on the surface. don't mix them up.

πŸ’œ SEE ALSO πŸ’œ


⭐ SINCE ⭐

5.1.9 β€” so this has been iconic since way back πŸŽ€


and that's the page, bestie!! πŸ¦‹πŸ’– take care of your filesystem walkers, they're doing their best.

Allegro reference manual Β· page ALLEGRO_FOR_E..._ENTRY_RESULT(3alleg5) Β· mwah, thanks for reading, slay βœ¨πŸ’…πŸŒˆ

πŸ“¦ where this page comes from