Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
al_findfirst(3)			Allegro	manual		       al_findfirst(3)

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  at-
       trib);

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  oc-
       curred  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(3), al_findclose(3),	al_ffblk_get_size(3)

Allegro				 version 4.4.2		       al_findfirst(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=al_findfirst&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help