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

Files.CopyFile

Copies files and folders without user interface.

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

Parameters

Parameter Description Example Flags
SourcePath The native path to the file or folder to be copied. "/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.
(ignored on other platforms)
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

Copies files and folders without user interface.
SourcePath and DestPath must be valid and exist. So pass destination folder for the destination.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.

The Linux implementation copies file to dest. You need to have read permissions for source file. We try to preserve extended attributes and file permissions.

On Windows the 5th parameter can be 1 to use alternative copy function from Windows. This one is for copying one file only, but may be more successful in some cases.

Examples

Copy a file:

MBS( "Files.CopyFile"; "/Users/cs/Desktop/test.pdf"; "/Users/cs/Desktop/copy.pdf")

Copy file on Windows with alternative copy method:

MBS( "Files.CopyFile"; "D:\Arbeitsunterlagen\Problemloesungsbericht_SDAG_WM.xlsx"; "D:\Files_for_ZIP/CC__8D_1997_01_02__LU_53145345__2_97.xlsx"; 0; 0; 1)

Copy a file from desktop to a network volume:

MBS( "Files.CopyFile"; "C:\Users\Christian\Desktop\test.mov"; "Z:\Files\test.mov")

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 3th January 2020


Files.CanOpenFile - Files.CopyFiles