4D v18
file.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
file.copyTo( )
The file.copyTo( ) method copies the File object (source file) into the specified destinationFolder.
The destinationFolder must exist on disk, otherwise an error is generated.
By default, the file is copied with the name of the original file. 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 file with the same name already exists in the destinationFolder, by default 4D generates an error. You can pass the fk overwrite constant in the overwrite parameter to ignore and overwrite the existing file:
| Constant | Value | Comment |
| fk overwrite | 4 | Overwrite existing elements, if any |
Returned object
The method returns the copied File object.
You want to copy a picture file from the user's document folder to the database folder:
C_OBJECT($source;$copy)
$source:=Folder(fk documents folder).file("Pictures/photo.png")
$copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite)
Product: 4D
Theme: File and Folder
4D Language Reference ( 4D v18)
