Click above to get retro games delivered to your door ever month!

findfirst

Usage

   #include <dos.h>

   struct FIND *findfirst(char *pathname,int attribute);

Description

   The system calls findfirst and findnext are used to find files matching a
   file description possibly containing wild cards (i.e.  *  or  ? ). The
   wild cards can be in the file name or extension, but not the path. The
   attribute argument is the file attribute of the files to be found.

   More than one attribute bit can be passed in the findfirst call. The
   attribute bits are defined in dos.h and are:

           Attribute       Bit Mask
           ---------       ---------
           FA_RDONLY       0x01
           FA_HIDDEN       0x02
           FA_SYSTEM       0x04
           FA_LABEL        0x08
           FA_DIREC        0x10
           FA_ARCH         0x20


   A value of 0 for the attribute will find all normal files. A pointer to a
   static structure (defined in dos.h) is returned upon success, otherwise a
   NULL is returned.

Example 

   See findnext.

Return Value

   A pointer to a static struct FIND as defined in dos.h is returned on
   success. A NULL pointer indicates the end of filename matches or an error
   (such as no matching files).