Modification d'un nom de fichier

De RAD Studio
Aller à : navigation, rechercher

Remonter à Manipulation de fichiers

Pour changer un nom d'un fichier, utilisez la fonction System.SysUtils.RenameFile :

Delphi :
 function RenameFile(const OldFileName, NewFileName: string): Boolean;
C++ :
extern DELPHI_PACKAGE bool __fastcall RenameFile(const System::UnicodeString OldName,
    const System::UnicodeString NewName);

RenameFile remplace un nom de fichier, identifié par OldFileName, par le nom spécifié par NewFileName. Si l'opération réussit, RenameFile renvoie True. Si le fichier ne peut pas être renommé (par exemple, si un fichier appelé NewFileName existe déjà), RenameFile renvoie False. Par exemple :

Delphi :
 if not RenameFile('OLDNAME.TXT','NEWNAME.TXT') then
   ErrorMsg('Error renaming file!');
C++ :
if (!RenameFile("OLDNAME.TXT","NEWNAME.TXT"))
    ErrorMsg("Error renaming file!");

Il n'est pas possible de renommer (déplacer) un fichier entre des lecteurs en utilisant RenameFile. Pour ce faire, vous devez commencer par copier le fichier, puis supprimer le fichier original.

Remarque : RenameFile dans la VCL-RTL est une enveloppe pour la fonction MoveFile de l'API Windows, et MoveFile ne fonctionne donc pas non plus d'un lecteur à l'autre.

Voir aussi