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: 9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4   10.5   10.6    Statistic    FMM    Blog  

Files.CreateDirectory

Creates a directory.

Component Version macOS Windows Server FileMaker Cloud FileMaker 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

Example Databases

Blog Entries

FileMaker Magazin

Release notes

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


Files.CreateBookmark   -   Files.CreateHardLink

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins