メインコンテンツまでスキップ

ファイルまたはディレクトリを移動する (file.move)

宣言​

操作成否, エラー情報 = file.move(移動元パス, 移動先パス [, モード])

パラメータ​

  • 移動元パス
    文字列型。ファイルの絶対パス
  • 移動先パス
    文字列型。ファイルの絶対パス
  • モード 20250914+
    文字列型。省略可能。移動モード。指定できる値：
    • 空文字列または省略：デフォルトモード（no-clobber）。移動先がすでに存在する場合は失敗を返します
    • "overwrite" または "o"：上書きモード。既存の移動先をそのまま置き換えます（既存の移動先は削除されます）
    • "merge" または "m"：マージモード（ディレクトリのみ）。移動先にすでに存在するファイルを保持します
    • "overwrite-merge" または "om"/"mo"：上書きマージモード。ディレクトリをマージし、同名のファイルを上書きします

戻り値​

  • 操作成否
    ブール型。操作に成功した場合は true、失敗した場合は false を返します
  • エラー情報
    文字列型。操作に失敗した場合のエラー情報

説明​

ファイルまたはディレクトリを 移動元パス から 移動先パス へ移動します。同じパス内で名前を変更する操作は、リネームに相当します
キーワード：ファイル名の変更、ディレクトリ名の変更、フォルダー名の変更、ファイルの移動、ディレクトリの移動、フォルダーの移動
この関数は 20250313 以降のバージョンでのみ使用できます

使用例​

ok, err = file.move(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
    sys.alert('移动失败：'..err)
end

注：上記のコードでは、この章以外の関数 sys.alert を使用しています