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:

   File-type      Attribute
   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 and a NULL pointer to indicate the end of filename matches  or
   an error (such as no matching files).