4D v18
folder.copyTo( )
- 4D Language Reference
-
- File and Folder
-
- File and folder object pathnames
- About ZIP Archives
- file.creationDate
- file.creationTime
- file.exists
- file.extension
- file.fullName
- file.hidden
- file.isAlias
- file.isFile
- file.isFolder
- file.isWritable
- file.modificationDate
- file.modificationTime
- file.name
- file.original
- file.parent
- file.path
- file.platformPath
- folder.creationDate
- folder.creationTime
- folder.exists
- folder.extension
- folder.fullName
- folder.hidden
- folder.isAlias
- folder.isFile
- folder.isFolder
- folder.isPackage
- folder.modificationDate
- folder.modificationTime
- folder.name
- folder.original
- folder.parent
- folder.path
- folder.platformPath
- folder.folder( )
- folder.file( )
- folder.folders( )
- folder.files( )
- folder.getIcon( )
- folder.rename( )
- folder.copyTo( )
- folder.moveTo( )
- folder.delete( )
- folder.create( )
- folder.createAlias( )
- file.getIcon( )
- file.rename( )
- file.copyTo( )
- file.moveTo( )
- file.delete( )
- file.create( )
- file.getContent( )
- file.setContent( )
- file.getText( )
- file.setText( )
- file.createAlias( )
- File
- Folder
- ZIP Create archiveNew
- ZIP Read archiveNew
folder.copyTo( )
The folder.copyTo( ) method copies the Folder object (source folder) into the specified destinationFolder.
The destinationFolder must exist on disk, otherwise an error is generated.
By default, the folder is copied with the name of the original folder. If you want to rename the copy, pass the new name in the newName parameter. The new name must comply with naming rules (e.g., it must not contain characters such as ":", "/", etc.), otherwise an error is returned.
If a folder with the same name already exists in the destinationFolder and is not empty, by default 4D checks its contents before copying the items and generates an error if a file with the same name exists. You can pass the fk overwrite constant in the overwrite parameter to ignore and overwrite the existing folder:
| Constant | Value | Comment |
| fk overwrite | 4 | Overwrite existing elements, if any |
Returned object
The method returns the copied Folder object.
You want to copy a Pictures folder from the user's Document folder to the Database folder:
C_OBJECT($userImages;$copiedImages)
$userImages:=Folder(fk documents folder+"/Pictures/")
$copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite)
Product: 4D
Theme: File and Folder
4D Language Reference ( 4D v18)
