file.rename( )

4D v19.8

file.rename( )

file.rename( ) メソッドはnewName 引数で指定した新しい名前でファイルの名称を変更し、名称変更したFile オブジェクトを返します。

newName 引数で指定する新しい名前は命名規則(例: ":", "/", などの文字を含んでいない等)に則っている必要があります。違反している場合、エラーが返されます。同じ名前のファイルが既に存在する場合、エラーが返されます。

このメソッドはファイルの完全な名前を書き換えるという点に注意してください。つまり、newName 引数に拡張子を渡さなかった場合、ファイルは拡張子の名前を持つことになります。

返されるオブジェクト

メソッドは名称が変更されたFile オブジェクトを返します。

"ReadMe.txt" を "ReadMe_new.txt":へと名前を変更したい場合を考えます:

 $toRename:=File("C:\\Documents\\Archives\\ReadMe.txt";fk platform path)

 $newName:=$toRename.rename($toRename.name+"_new"+$toRename.extension)