| Description |
The RenameFile function renames OldName file or directory to NewName, returning True if successful.
If a file or directory name is given without a path, the file must be in the current directory.
|
|
| Notes |
You can rename a file onto a different drive, although this is not recommended.
|
|
| Related commands |
| AssignFile |
|
Assigns a file handle to a binary or text file |
| DeleteFile |
|
Delete a file specified by its file name |
| Erase |
|
Erase a file |
| IOResult |
|
Holds the return code of the last I/O operation |
| Rename |
|
Rename a file |
|
|
|
| Example code : Rename Unit1.dcu to Unit1.old and back again |
var
oldName, newName : string;
begin
// Try to rename the current Unit1.dcu to Uni1.old
oldName := 'Unit1.dcu';
newName := ChangeFileExt(oldName, '.old');
if RenameFile(oldName, newName)
then ShowMessage('Unit1.dcu renamed OK')
else ShowMessage('Unit1.dcu rename failed with error : '+
IntToStr(GetLastError));
// Let us try the same rename again
if RenameFile(oldName, newName)
then ShowMessage('Unit1.dcu renamed again OK')
else ShowMessage('Unit1.dcu rename failed with error : '+
IntToStr(GetLastError));
// Finally, let us rename the file back again
if RenameFile(newName, oldName)
then ShowMessage('Unit1.old renamed back OK')
else ShowMessage('Unit1.old rename back failed with error : '+
IntToStr(GetLastError));
end;
|
| Show full unit code |
Unit1.dcu renamed OK
Unit1.dcu rename failed with error : 2
Unit1.old renamed back OK
|
|