Trash API

The Trash module provides a common interface for sending files to the operating systems concept of a "recycle bin".

Module Contents

void trash(string path)

This will send the specified file (path) to the operating system's recycle bin.

If the file doesn't exist, or we don't have permission to move the file, then FileException is thrown.

void trash(string path, out string pathInTrash)

NOTE: The pathInTrash parameter is only used on POSIX.

This will send the specified file (path) to the operating system's recycle bin. You can also find out the pathInTrash, which tells you the absolute path to the file in the recycle bin.

If the file doesn't exist, or we don't have permission to move the file, then FileException is thrown.

void erase(string path)

A convenience function which will erase the file from the operating system. Any files which are erased cannot be restored.