System.SysUtils.RenameFile

• Aller au parent : System.SysUtils

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

• System.SysUtils.DeleteFile

• System.Rename

• System.SysUtils.TSymLinkRec

• Support des entrées et des sorties des fichiers

Exemples de code

• ExtractFileName (C++)
• ExtractFileName (Delphi)