fichier.rename( )

4D v19.8

fichier.rename( )


fichier.rename ( nouveauNom ) -> Résultat

Paramètre	Type	Description
nouveauNom	Texte	Nouveau nom complet du fichier
Résultat	Objet	Fichier renommé

Description

La méthode file.rename( ) renomme le fichier avec le nom que vous avez passé dans le paramètre nouveauNom et retourne l'objet File renommé.

Le paramètre nouveauNom doit être conforme aux règles de nommage (ex : il ne doit pas contenir des caractères tels que ":", "/", etc.), sinon une erreur est retournée. S'il existe déjà un fichier portant le même nom, une erreur est retournée.

A noter que la méthode modifie le nom complet du fichier, c'est-à-dire que si vous ne passez pas une extension dans le paramètre nouveauNom, le fichier aura un nom sans extension.

Objet retourné

La méthode retourne l'objet File renommé.

Exemple

Vous souhaitez que "ReadMe.txt" soit renommé "ReadMe_new.txt" :

 $toRename:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)

 $newName:=$toRename.rename($toRename.name+"_new"+$toRename.extension)