HelpPC 2.10 Quick Reference Utility Copyright 1991 David Jurgens

       TC: int findfirst( const char *path, struct ffblk *ffblk, int attr)

       MSC unsigned _dos_findfirst( char *path, unsigned attr,
                                       struct find_t *fileinfo )

       - prototype in dir.h, also include dos.h (MS C: dos.h only)

       - gets disk directory via DOS 0x4E, where attr is:

                       Turbo C         Microsoft C

                       FA_RDONLY       _A_RDONLY
                       FA_HIDDEN       _A_HIDDEN
                       FA_SYSTEM       _A_SYSTEM
                       FA_LABEL        _A_VOLID
                       FA_DIREC        _A_SUBDIR
                       FA_ARCH         _A_ARCH

       struct ffblk    (Turbo C)       struct find_t   (MSC)
           {                               {
           char     ff_reserved[21];       char     reserved[21];
           char     ff_attrib;             char     attrib;
           unsigned ff_ftime;              unsigned wr_time;
           unsigned ff_fdate;              unsigned wr_date;
           long     ff_fsize;              long     size;
           char     ff_name[13];           char     name[13];
           };                              };

       - attributes can be logically OR'ed
       - struct ffblk is defined in Turbo C's dir.h
       - struct find_t is defined in MS C's dos.h
       - updates DTA, provisions for saving/setting DTA should be made
       - normal files are always included along with files that match
         the requested attributes except when the LABEL attribute is
         requested.  It's up to the programmer to determine which
         actually match the requested attributes.
       - returns 0 if OK, -1 if no matching files found or on error

       - see   FILE ATTRIBUTES,  FINDNEXT,  GETDTA  and  SETDTA

Esc or Alt-X to exit findfirst Home/PgUp/PgDn/End ←↑↓→
Converted to HTML in 2006 by Timo Bingmann