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

Files.CreateDirectory

Creates a directory.

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

(old name: Files.CreateFolder)

Parameters

Parameter Description Example
Path Native path to the new directory to be created. "C:\Test"

Result

Returns "OK" or error message.

Description

Creates a directory.
Returns "OK" if the directory already exists.
This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.
For MacOS & iOS creates folders recursively as needed.

In the Mac world we call it a folder, in the Windows world a directory. This function works cross platform and got the name with Directory years ago.

You can use Files.DeleteFolder to delete a folder with its content.
Changed for plugin version 10.5 to do recursive folder creation on Windows, too.

Examples

Create folder on Desktop:

Set Variable [$folder; Value:MBS( "Folders.UserDesktop" )]
If [IsEmpty(Container Export::Name)]
    Set Field [Container Export::Name; "Record " & Get(RecordID)]
End If
Set Variable [$path; Value:MBS( "Path.AddPathComponent"; $folder; Container Export::Name )]
Set Variable [$r; Value:MBS("Files.CreateDirectory"; $path)]

Creates directory and shows error:

Set Variable [$r; Value:MBS("Files.CreateDirectory"; $path)]
If [MBS("IsError")]
    Show Custom Dialog ["Failed to create directory"; MBS("Text.RemovePrefix"; $r; "[MBS] ")]
    Exit Script []
End If

Create a folder:

MBS( "Files.CreateDirectory"; "/Users/cs/Documents/FolderName" )

Create recursive folder structure on desktop:

MBS( "Files.CreateDirectory"; "C:\\Users\\Christian\\Desktop\\test1\\test2\\test3\\" )
// needs MBS Plugin 10.5 or newer

See also

Release notes

Example Databases

Blog Entries

Created 18th August 2014, last changed 23th October 2020


Files.CreateBookmark - Files.CreateHardLink