RenameFile - C++ Builder

C++ Builder 参考手册 ➙ System::Sysutils ➙ RenameFile

---

给文件改名

头文件：#include
命名空间：System::Sysutils
函数原型：

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

参数：

• OldName：原文件名；
• NewName：新文件名；

返回值：

• true：文件改名成功；
• false：文件改名失败，文件不存在，没有权限等；
• 如果 NewName 是已经存在的文件，不同的操作系统表现也不同，在 Windows 里面改名失败；
• 如果 OldName 是符号链接 (symbolic link)，链接的目标被改名；
• 如果 NewName 和 OldName 在不同的文件夹里面，会把改名之后的文件移动到 NewName 指定的文件夹里面；
• 在 Windows 里面，这个函数是通过调用 API 函数 MoveFile 实现的。

---

相关：

• System::Sysutils::CreateDir
• System::Sysutils::ForceDirectories
• System::Sysutils::RemoveDir
• System::Sysutils::FileCreateSymLink
• System::Sysutils::FileGetSymLinkTarget
• System::Sysutils::GetCurrentDir
• System::Sysutils::SetCurrentDir
• System::Sysutils::DeleteFile
• System::Sysutils::RenameFile
• System::Sysutils::FileExists
• System::Sysutils::DirectoryExists
• System::Sysutils::FileSearch
• System::Sysutils::FindFirst
• System::Sysutils::FindNext
• System::Sysutils::FindClose
• System::Sysutils::FileAge
• System::Sysutils::FileGetDate
• System::Sysutils::FileGetDateTimeInfo
• System::Sysutils::FileSetDate
• System::Sysutils::FileGetAttr
• System::Sysutils::FileSetAttr
• System::Sysutils::FileIsReadOnly
• System::Sysutils::FileSetReadOnly
• System::Sysutils::IsAssembly
• System::Sysutils::DiskFree
• System::Sysutils::DiskSize
• System::Sysutils::FileDateToDateTime
• System::Sysutils::DateTimeToFileDate
• System::Sysutils::RaiseLastOSError
• System::Sysutils::CheckOSError
• System::Sysutils
• System::Ioutils::TFile::Move
• System::Ioutils

---

C++ Builder 参考手册 ➙ System::Sysutils ➙ RenameFile