Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 11.5   12.0   12.1   12.2   12.3   12.4   12.5   13.0   13.1   13.2    Statistic    FMM    Blog  

Files.MoveFile

Moves a file or folder without user interface.

Component Version macOS Windows Linux Server iOS SDK
Files 2.8 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "Files.MoveFile"; SourcePath; DestPath { ; Overwrite; SkipSourcePermissionErrors; ProgressTitle } )   More

Parameters

Parameter Description Example Flags
SourcePath The native path to the file or folder to be moved. "/Users/John/Desktop/test.txt"
DestPath The native path to the destination folder or file. "/Users/John/Desktop/Backup/"
Overwrite Mac only: Whether to allow overwriting existing files.
Default is off. Pass 1 to enable and 0 to disable.
On Windows, it overwrites always.
1 Optional
SkipSourcePermissionErrors Mac only: Whether to skip files with permission errors.
Default is off. Pass 1 to enable and 0 to disable.
1 Optional
ProgressTitle Title for the progress window.
For Windows only and the text may not be visible in your version of Windows.
"Copying FileMake files" Optional

Result

Returns OK or error message.

Description

Moves a file or folder without user interface.
SourcePath and DestPath must be valid and exist. So pass destination folder for the destination.

The Linux implementation does only move files within the same file system.
On Mac you may get error -43 for file not found if you refer to a file in a folder, where you don't have file permissions to look inside the folder.

See also Files.RenameFile to rename a file.

On Windows, if the destination path is relative, it is applied to the current process' working directory. See Process.SetCurrentDirectory to change that.

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

Move a file:

MBS( "Files.MoveFile"; "C:\Users\Christian\Desktop\test1.txt"; "C:\Users\Christian\Desktop\test2.txt")

See also

Release notes

Example Databases

Blog Entries

This function checks for a paid license.

Created 18th August 2014, last changed 26th February 2023


Files.MountPath - Files.MoveToTrash

💬 Ask a question or report a problem


Start Chat