4D v18

fichier.rename( )

Accueil

 
4D v18
fichier.rename( )

fichier.rename( )  


 

La méthode fichier.rename( ) renomme le fichier avec le nom que vous avez passé dans le paramètre nouveauNom et retourne l'objet renommé (#cmd id="1567"/]. 

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 Fichier renommé.

Exemple  

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

 $toRename:=Fichier("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)
 $newName:=$toRename.rename($toRename.name+"_new"+$toRename.extension)

 
PROPRIÉTÉS 

Produit : 4D
Thème : Fichier et dossier
Nom intl. : file.rename( )

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
PAGE CONTENTS 
 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v18)