TFloFileSearch Class

The NewFileSearch function returns a TFloFileSearch object.

The TFloFileSearch object class supports the properties as listed in the table below, in the format -

TFloFileSearch.<property>

Property Name	Description
Count	The number of matching files. Accessing this property causes the search criteria to be re-applied and a new file search to be performed to identify the matching files AND to be performed again to reset the search to enable files to be processed individually if required.
EOF	Indicates that no more files are found. Use in conjunction with the Next method (as described below) to process matching files one at a time, using the FileAttr, FileName and FileSize properties.
Exists	Indicates whether any files match the criteria.
FileAttr	ATTR mask for the current file.
FileName	Filename of the current file.
FileSize	The size (in bytes) of the current file.

TFloFileSearch also supports the following methods as below, using the format -

TFloFileSearch.<method>

Method Name	Description
GetFileNames(TStringList)	Retrieves a list of all matching filenames that meet the search criteria into the TStringList supplied. This list must be created before calling the method.
Next	Call this method to advance the search to the Next matching file. Use in conjunction with the EOF, FileAttr, FileName and FileSize properties.
Free	Empties/clears the TFloFileSearch object. Calling this method causes the search criteria to be re-applied and a new file search to be performed to identify the matching files AND to be performed again to reset the search to enable files to be processed individually if required.

The TFloFileSearch object result that is returned must be disposed of when finished with, using the Free method, as per the following example.

vsearch := NewFileSearch(PATH, SPEC, ATTR);
try
//The code to be processed
finally
  vsearch.Free;
end;

For additional information, please refer to the NewFileSearch function.