# FileRecycle

Sends a file or directory to the recycle bin if possible, or permanently deletes it.

    FileRecycle, FilePattern

## Parameters

FilePattern

  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.

  To recycle an entire directory, provide its name without a trailing backslash.

## Error Handling

[v1.1.04+]: This command is able to throw an exception on failure. For more information, see Runtime Errors.

ErrorLevel is set to 1 if there was a problem or 0 otherwise.

## Remarks

SHFileOperation is used to do the actual work. This function may permanently delete the file if it is too large to be recycled; as of [v1.0.96], a warning should be shown before this occurs.

The file may be permanently deleted without warning if the file cannot be recycled for other reasons, such as:

- The file is on a removable drive.
- The Recycle Bin has been disabled, such as via the `NukeOnDelete` registry value.

## Related

FileRecycleEmpty, FileDelete, FileCopy, FileMove

## Examples

#1

    FileRecycle, C:\temp files\*.tmp