System.SysUtils.RenameFile

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function RenameFile(const OldName, NewName: string): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall RenameFile(const System::UnicodeString OldName, const System::UnicodeString NewName);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Change le nom d'un fichier.

RenameFile tente de changer le nom du fichier spécifié par OldFile en NewFile. Si l'opération réussit, RenameFile renvoie True. Si RenameFile ne peut pas renommer le fichier (par exemple, si l'application n'a pas la permission de modifier le fichier), elle renvoie False.

Remarque : Si le paramètre OldName est un lien symbolique, la méthode est exécutée sur le fichier cible.

Remarque : Si NewFile représente le nom d'un fichier existant, RenameFile a un comportement différent sous Windows et sous Macintosh. Sous Windows, l'opération de renommage échoue.

Voir aussi

Exemples de code