You are here: Start » Function Reference » File System » EnumerateFiles_Random

EnumerateFiles_Random

Header:	STD.h
Namespace:	fil

Enumerates the files present in a disk directory sorted randomly.

Syntax

bool fil::EnumerateFiles_Random
(
	EnumerateFilesState& ioState,
	const ftl::Directory& inDirectory,
	const ftl::String& inExtensions,
	ftl::Optional<int> inSeed,
	bool inRepeat,
	bool inProcessSubdirectories,
	bool inInvert,
	ftl::File& outFilePath,
	ftl::String& outFileName
)

Parameters

Name	Type	Description
ioState	EnumerateFilesState&	Object used to maintain state of the function.
inDirectory	const Directory&	Input directory
inExtensions	const String&	Allowed extensions separated by semicolon
inSeed	Optional<int>	Random seed used to determine random sorting order
inRepeat	bool	Determines whether to repeat reading directory after reading all files
inProcessSubdirectories	bool	Flag indicating whether to enumerate files from the subdirectories or not
inInvert	bool	Flag indicating whether to enumerate files backwards or not
outFilePath	File&	Output file path
outFileName	String&	Output file name

Errors

List of possible exceptions:

Error type	Description
DomainError	Cannot sort by file creation date on Linux.
DomainError	Directory doesn't exist: Directory path
DomainError	Empty string is not a valid directory path.