FileDelete

Deletes one or more files permanently.

FileDelete FilePattern

Parameters

FilePattern

Type: String

The name of a single file or a wildcard pattern such as "C:\Temp\*.tmp". FilePattern is assumed to be in A_WorkingDir if an absolute path isn't specified.

Both asterisks (*) and question marks (?) are supported as wildcards. * matches zero or more characters and ? matches any single character. Usage examples:

To remove an entire folder, along with all its sub-folders and files, use DirDelete.

Error Handling

An Error is thrown if any files failed to be deleted, with its Extra property set to the number of failures. Deleting a wildcard pattern such as "*.tmp" is considered a success even if it does not match any files.

If files were found, A_LastError is set to 0 (zero) or the result of the operating system's GetLastError() function immediately after the last failure. Otherwise A_LastError contains an error code that might indicate why no files were found.

Remarks

To send a file to the recycle bin, use the FileRecycle function.

To delete a read-only file, first remove the read-only attribute. For example: FileSetAttrib "-R", "C:\My File.txt".

FileRecycle, DirDelete, FileCopy, FileMove

Examples

Deletes all .tmp files in a directory.

FileDelete "C:\temp files\*.tmp"