This function moves files and/or folders to the trash. Any item can be moved to the trash as long as you have the required permission and it is on a volume which supports the trash. This includes audio files.
The text field may contain any of the escape sequences described in Escape Sequences. The text field is list aware. After escaping the field, it is decomposed into separate items delimited by newline (\n) or default list delimiter (\~) characters. Every item in the resolved list must be an absolute (/) or relative to the home folder (~/) file or folder path. Leading and trailing spaces are ignored in each list element.
You can optionally choose to delete files if they cannot be moved to the trash. Warning: This option is extremely dangerous!.
The text field can be displayed in a multi-line editor by clicking on the control to the right of the field. \n sequences are changed to newline characters when displayed and changed back to \n sequences after editing.
Regardless of the execution mode, the function is only executed once.
The action test state is set to true if all specified items were moved to the trash. If at least one item was not moved, or there were no items, the action test state will be set to false.
This statement does not make the trash noise and Put Back is not available for moved files.
Examples:
Trash Files and Folders in "\?do/test.txt \n /Volumes/Share/folder1"
Set named variable 'Stuff to Trash' to "\?do/test.txt \n /Volumes/Share/folder1"
Trash Files and Folders in "\<Stuff to Trash>"
Trash Files and Folders in "\?do/test.txt"
The first Trash Files and Folders statement trashes a file named test.txt in the Documents folder (\?do inserts a path to the Documents folder) and a folder at /Volumes/Share/folder1.
The second Trash Files and Folders statement is functionally identical to the first. The list is specified in a named variable.
The third Trash Files and Folders statement trashes only a single file as no list separators are present.
Be careful with this statement.