#include <dos.h> unsigned int _dos_findfirst(char *name, unsigned int attr, struct find_t *result);
This function and the related _dos_findnext
(see section _dos_findnext)
are used to scan directories for the list of files therein. The name
is a wildcard that specifies the directory and files to search. result
is a structure to hold the results and state of the search, and attr
is a combination of the following:
_A_NORMAL (0x00)
_A_RDONLY (0x01)
_A_HIDDEN (0x02)
_A_SYSTEM (0x04)
_A_VOLID (0x08)
_A_SUBDIR (0x10)
_A_ARCH (0x20)
See section _dos_findnext.
This function does not support long filenames, even on systems where the LFN API (see section _use_lfn) is available. For LFN-aware functions with similar functionality see section findfirst, and section findnext. Also see section opendir, and section readdir, which are Posix-standard.
Zero if a match is found, DOS error code if not found (and sets errno).
not ANSI, not POSIX
#include <dos.h> struct find_t f; if ( !_dos_findfirst("*.DAT", &f, _A_ARCH | _A_RDONLY) ) { do { printf("%-14s %10u %02u:%02u:%02u %02u/%02u/%04u\n", f.name, f.size, (f.wr_time >> 11) & 0x1f, (f.wr_time >> 5) & 0x3f, (f.wr_time & 0x1f) * 2, (f.wr_date >> 5) & 0x0f, (f.wr_date & 0x1f), ((f.wr_date >> 9) & 0x7f) + 1980); } while( !_dos_findnext(&f) ); }
Go to the first, previous, next, last section, table of contents.