API version 4

FileSystem.Renameメソッド

iOSAndroidWindows

説明

ファイル名またはフォルダ名を変更します。

変更前と変更後で親フォルダが異なる場合、ファイルまたはフォルダは移動されます。

変更後の名前と同じ名前のファイルまたはフォルダが既に存在する場合は、以下の動作になります。

変更前	変更後	動作
ファイル	ファイル	上書き確認ダイアログが表示されます。OKを選択するとファイルが上書きされます。
ファイル	フォルダ	変更前のファイルは、変更後のフォルダ内に移動します。
フォルダ	ファイル	上書き確認ダイアログが表示されます。OKを選択するとファイルが削除され、フォルダが移動（名前が変更）されます。
フォルダ	フォルダ	変更前のフォルダは、変更後のフォルダ内に移動します。

フォルダを作成する必要がある場合は、確認ダイアログが表示されます。

ファイル操作でエラーが発生した場合は、メッセージボックスが表示されます。

呼出形式

var f = fs.Rename( oldName, newName [, flag ] )

戻り値

名前の変更が正常に完了した場合は$TRUE、それ以外は$FALSEを返します。

引数

String oldName

変更前の仮想ファイル名

String newName

変更後の仮想ファイル名

integer flag

動作を以下の組み合わせで指定します

定数	説明
FileSystem.NOCONFIRM	確認ダイアログを表示しません
FileSystem.NOERRORUI	エラー表示を行いません

flagを省略した場合は、

・確認ダイアログを表示

・エラー時はメッセージボックスを表示

となります。

例外

なし

使用例

var fs = new FileSystem;
if (fs.Rename("/app1", "/app2", FileSystem.NOCONFIRM + FileSystem.NOERRORUI)) {
    MessageBox("名前を変更しました");
}