GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AL_FINDFIRST (3)

NAME

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

CONTENTS

Synopsis
Description
See Also

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(3), al_findclose(3), al_ffblk_get_size(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro AL_FINDFIRST (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.