folder.create( )

Home

4D v19

folder.create( )

Description

The folder.create( ) method creates a folder on disk according to the properties of the Folder object.

If necessary, the function creates the folder hierachy as described in the folder.path or folder.platformPath property. If the folder already exists on disk, the function does nothing (no error is thrown) and returns false.

Returned value

true if the folder is created successfully;
false if a folder with the same name already exists or if an error occured.

Example 1

Create an empty folder in the database folder:

 C_OBJECT($prefs)

 C_BOOLEAN($created)

 $created:=Folder("/PACKAGE/SpecialPrefs").create()

Example 2

Creation of the "/Archives2019/January/" folder in the database folder:

 $newFolder:=Folder("/PACKAGE/Archives2019/January")

 If($newFolder.create())

    ALERT("The "+$newFolder.name+" folder was created.")

 Else

    ALERT("Impossible to create a "+$newFolder.name+" folder.")

 End if