System.SysUtils.RenameFile

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

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

C++

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

プロパティ

種類 可視性 ソース ユニット
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils


説明

ファイル名を変更します。

RenameFile は、OldFile で指定されたファイルの名前を NewFile に変更しようと試みます。 操作が成功すれば、RenameFile は、True を返します。 ファイル名を変更できない場合(たとえば、アプリケーションにファイルを変更する権限がない場合など)、RenameFileFalse を返します。

メモ:OldName パラメータが symbolic link の場合、このメソッドはtarget fileに対して実行されます。

メモ:NewFile が既存のファイルの名前を表す場合、RenameFile の動作は WindowsMacintosh で異なります。 Windows では、名前を変更する操作が失敗します。

関連項目

コード サンプル