CFindFiles:new

CFindFiles:new

The new method constructs a new instance of a CFindFiles object. The CFindFiles class iterates over files in a folder, fetching the names of files matching a template. Three different constructor overloads are available to create a new CFindFiles and initialize the properties.

Syntax

F = CFindFiles:new()

Creates a new object. You must call Open before file searching can be performed.

F = CFindFiles:new( sFolder )

Opens file searching inside the named folder. The folder name is a complete path specification. Unless later changed by the Open method, the filename template is initialized to *.*.

F = CFindFiles:new( sFolder, sTemplate )

Creates a new CFindFiles object for the specified folder using the specified file name template. The folder name is a complete path specification.

Remarks

Three overloads are provided for this method. If you use the default constructor with no arguments, then the Open method must be called to set the folder where searching is to be done. If the folder and optional template are specified in the constructor, then the Open method need not be called before calling Next.

Example

The following script fragment lists files inside the folder specified by the string sFolder:

F = CFindFiles:new( sFolder )	-- Create a new CFindFiles object
while F:Next() do	-- Iterate to the next file
Printf("%s\r\n", F:GetPath() )	-- list the current path name
end
F:Close()	-- finished with this object