debian man page for al_findfirst

al_findfirst(3alleg4)						  Allegro manual					     al_findfirst(3alleg4)

NAME
       al_findfirst - Low-level function for searching files. Allegro game programming library.

SYNOPSIS
       #include <allegro.h>

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

DESCRIPTION
       Low-level  function  for  searching  files.  This  function  finds  the	first file which matches the given wildcard specification and file
       attributes (see above). The information about the file (if any) will be put in the al_ffblk  structure  which  you  have  to  provide.  The
       al_ffblk structure looks like:

	  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 is some other stuff in the structure as well, but it is there for internal use only. Example:

	  struct al_ffblk info;

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

RETURN VALUE
       The  function  returns  non-zero if no match is found or if an error occurred and, in the latter case, sets `errno' accordingly. It returns
       zero if a match is found, allocating some memory for internal use in the structure.  Therefore you have to close your search when  you  are
       finished to avoid memory leaks in your program.

SEE ALSO
       al_findnext(3alleg4), al_findclose(3alleg4), al_ffblk_get_size(3alleg4)

Allegro 							   version 4.4.2					     al_findfirst(3alleg4)