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

 C_FINDFIRST()

 DESCRIPTION

 C_FINDFIRST() returns the first file found matching the given file
 specification and attributes.  A data buffer is loaded with
 information about the file such as the size, date, time, and
 attributes.   The C_FFSIZE(), C_FFDATE(), C_FFTIME(), and
 C_FFATTR() functions retrieve the information.

 NOTES

 After a file is found with C_FINDFIRST(), use the C_FINDNEXT()
 function to locate additional files.

 SYNTAX

 C_FINDFIRST(filespec [,attr])

 PARAMETERS

 filespec (C) is the file specification to be used to search for
 files.  The filespec argument can be any valid DOS file name and
 can include wild card characters (*, ?).  The complete file name
 including drive and path can be specified.  If a drive and path are
 not given, the search is made in the current directory.

 attr (C) is a character string containing the attributes that are
 acceptable for inclusion of the file(s) found in the search.  Only
 files found with matching attributes are included.  Any number of
 attributes can be specified in the string.  The following is a list
 of valid attributes:

 ATTRIBUTE   DESCRIPTION
 ---------   -----------
 N           Normal files (no R, H, S, or D with or without archive bit)
 R           Read-only files
 H           Hidden files
 S           System files
 D           Directories
 A           Archive attribute set

 RETURNS

 C_FINDFIRST() returns the name of the first file found matching the
 given file specification and attributes, or null ("") if no file is
 found.

 EXAMPLES

 && Display all the "normal" files in the current directory
 xfile = c_findfirst("*.*","N")
 ...
 do while !empty(xfile)
   ? xfile
   xfile = c_findnext("*.*","N")
 enddo