4D v19
file.rename( )
- 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
- file.size
- 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 archive
- ZIP Read archive
file.rename( )
The file.rename( ) method renames the file with the name you passed in newName and returns the renamed File object.
The newName parameter 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, an error is returned.
Note that the method modifies the full name of the file, i.e. if you do not pass an extension in newName, the file will have a name without an extension.
Returned object
The method returns the renamed File object.
You want to rename "ReadMe.txt" in "ReadMe_new.txt":
$toRename:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)
$newName:=$toRename.rename($toRename.name+"_new"+$toRename.extension)
Product: 4D
Theme: File and Folder
4D Language Reference ( 4D v19)
4D Language Reference ( 4D v19.1)
