移動檔案或目錄 (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