FindFiles

void fil::FindFiles
(
	const ftl::Directory& inStartDirectory,
	const ftl::String& inMask,
	bool inSubdirs,
	ftl::Optional<fil::FileSortingOrder::Type> inSortingOrder,
	ftl::Array<ftl::File>& outFilePaths,
	ftl::Array<ftl::String>& outFileNames,
	bool& outFound = ftl::Dummy<bool>()
)

Working with Find Files

Start with defining a directory path in inStartDirectory port to choose where you want to look for files. To search files in subdirectories set inSubdirs to 'true'.

inMask pattern string

Port inMask specifies wildcard pattern that selects files this filter will operate on. Supported wildcards:

• * - any string of characters, including no characters
• ? - exactly one character

You can use any expression like examples below:

Examples:

• * - all files,
• *.jpg - files only with extension .jpg,
• Filename.* - files with name "Filename" and any extension, including no extension e.g. "Filename."
• Filename.?? - files with name "Filename" and two letter extension,

List of possible exceptions:

Error type	Description
DomainError	Given start directory is invalid in FindFiles.
IoError	Error opening start directory in FindFiles.

• TestFileExists – Checks if a given file is present.