Back to Aurora Vision Library Lite website

You are here: Start » System » File System » RemoveFile_Multiple

RemoveFile_Multiple


Header: STD.h
Namespace: avl

Removes files that match a pattern from a directory.

Syntax

void avl::RemoveFile_Multiple
(
	const atl::Directory& inStartDirectory,
	const atl::String& inMask,
	bool inProcessSubdirectories,
	bool& outSuccess
)

Parameters

Name Type Default Description
Input value inStartDirectory const Directory& Path to the directory from which the files are to be deleted
Input value inMask const String& Wildcard pattern
Input value inProcessSubdirectories bool Process subdirectories recursively
Output value outSuccess bool& Whether the deletion was successful or not

Remarks

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,

Errors

List of possible exceptions:

Error type Description
DomainError inMask needs to be filled in
DomainError inStartDirectory needs to be filled in

See Also

  • FindFiles – Returns files of the input directory.