Перемещение файла или каталога (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.