Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Files.MoveToTrash

Deletes an item by moving it to trash without user interface.

Component Version macOS Windows Linux Server iOS SDK
Files 2.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Files.MoveToTrash"; Path )   More

Parameters

Parameter Description Example
Path The native file path to the file or folder to be deleted. "/Users/John/Desktop/test.txt"

Result

Returns OK or error message.

Description

Deletes an item by moving it to trash without user interface.
Use this functions to move files and folders to the trash.

It is possible that the OS decides to not delete the file and fail (e.g. due to permission errors) or that the medium does not have a trash, so the file is deleted right away.

On Windows you can't delete/move an open file.

If you delete a file in a server script on a macOS server, the item is moved into the /Library/FileMaker Server/.Trash folder.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Delete a file on desktop on Mac by moving it to trash:

$r = MBS("Files.MoveToTrash"; "/Users/cs/Desktop/testing.fp7")

Delete a file on desktop on Windows by moving it to trash:

$r = MBS("Files.MoveToTrash"; "C:\Users\Christian\Desktop\testing.fp7")

Delete a file to trash with path in variable:

$r = MBS("Files.MoveToTrash"; $Path)

See also

Release notes

  • Version 11.1

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 9th March 2021


Files.MoveFile - Files.ReadAndWriteFile