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

Files.RenameFile

Renames 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.RenameFile"; Path; NewName )   More

Parameters

Parameter Description Example
Path The native path to the file or folder to be renamed. "/Users/John/Desktop/test.txt"
NewName The new name. "testfile.txt"

Result

Returns OK or error message.

Description

Renames a file or folder without user interface.
Path must be valid and exist.

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

Rename file on Windows with full path:

MBS( "Files.RenameFile"; "\\FileServer\Dokumente\VK\123456\RG249388345.pdf" ; "\\FileServer\Dokumente\VK\123456\Rechnung_249388345.pdf" )

Rename file on OS X:

MBS( "Files.RenameFile"; "/Users/cs/Desktop/test"; "Hello World, just a test!" )

Rename on Windows:

MBS( "Files.RenameFile"; "C:\Users\Administrator\Desktop\alt.fmp12"; "neu.fmp12")

See also

Release notes

  • Version 14.4
    • Fixed a problem in Files.RenameFile function to rename folders on Windows if the path ended with a backslash.
  • Version 8.2
  • Version 7.4
    • Changed Files.RenameFile to accept only file name as second parameter instead of file path for Windows. That was inconsistent to the Mac behavior where the name was enough.

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 5th August 2017


Files.ReadPNG - Files.ResolveAlias