bionic (3) for_each_file_ex.3alleg4.gz

NAME

       for_each_file_ex  -  Executes  callback()  for  each  file  matching a wildcard. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       int for_each_file_ex(const  char  *name,  int  in_attrib,  int  out_attrib,  int  (*callback)(const  char
       *filename, int attrib, void *param), void *param);

DESCRIPTION

       Finds  all  the  files  on  disk  which  match  the given wildcard specification and file attributes, and
       executes callback() once for each.  Basically,  this  is  a  convenient  wrapper  around  al_findfirst(),
       al_findnext()  and  al_findclose().  `in_attrib'  is  a  bitmask specifying the attributes the files must
       carry, `out_attrib' is a bitmask specifying the attributes the files must not carry; attributes which are
       not specified in either bitmasks are not taken into account for deciding whether callback() is invoked or
       not.

       The callback function will be passed three arguments: the first is a string which contains the  completed
       filename  (exactly the same string you passed to for_each_file_ex() but with meta characters), the second
       is the actual attributes of the file, and the third is a void pointer which is simply a copy  of  `param'
       (you  can  use this for whatever you like). The callback must return zero to let the enumeration proceed,
       or any non-zero value to stop it. If an error occurs, the error code will be stored in  `errno'  but  the
       enumeration won't stop. Example:

          int show_name(const char *filename, int attrib, void *param)
          {
             allegro_message("Caught `%s', attribs %d\n",
                             filename, attrib);
             return 0;
          }
          ...
             count = for_each_file_ex("data/level*", FA_DIREC,
                                      0, show_name, 0);
             allegro_message("%d game directories\n", count);

RETURN VALUE

       Returns  the  number  of successful calls made to callback(), that is, the number of times callback() was
       called and returned 0.

SEE ALSO

       al_findfirst(3alleg4), al_findnext(3alleg4), al_findclose(3alleg4)