FileRename

 

ファイルの名前の変更(ディスク上)

ディスク上のファイルの名前を変更します。

構文:

FileRename(元ファイル,新ファイル)

パラメータ:

  • 元ファイル …… 名前を変更するファイルの名前

  • ファイル …… 変更後の名前

ファイル名は、最大260バイトまで。unicode特有の文字は利用できません。

戻り値:

論理値 …… 処理に成功した場合「True」が返ります。

例:

FileRename('MAGIC.FILE','MAGIC.SAV')

 

MAGIC.FIL という名前がMAGIC.SAVに変更されます。

注意事項:

  • 2 つのパラメータにはそれぞれ、パスを指定することもできます。パスを省略した場合、ディレクトリはカレントディレクトリと解釈されます。

  • (ドライブ名が間違っていたなどの理由で)リネームできなかった場合、指定されたドライブにファイルがコピーされます。

プラットフォーム仕様:

Androidデバイスの場合、ファイルシステムは大文字と小文字を区別します。Magic xpa関連のファイル(例えばイメージやローカルデータベース)の名前は、小文字(ファイルが大文字で定義されていても)で、自動的に保存されます。この関数は、ファイル名を小文字に変換しません。したがって、Magic xpaで転送先のファイルを参照する必要がある場合、関数で小文字の名を使用しなければなりません。

関連トピック:

FileCopy, FileExist, FileDelete, FileSize