Mover um arquivo ou diretório (file.move)

Declaração

sucesso, mensagem_de_erro = file.move(caminho_de_origem, caminho_de_destino [, modo])

Parâmetros

• caminho de origem
  Texto; caminho absoluto do arquivo.
• caminho de destino
  Texto; caminho absoluto do arquivo.
• modo (20250914+)
  Texto opcional; modo de movimentação:
  • string vazia ou omitido: modo padrão (no-clobber), falha quando o destino já existe
  • "overwrite" ou "o": modo de substituição, substitui diretamente o destino existente (o destino existente será excluído)
  • "merge" ou "m": modo de mesclagem (somente para diretórios), preserva arquivos já existentes no destino
  • "overwrite-merge" ou "om"/"mo": modo de mesclagem com substituição, mescla diretórios mas substitui arquivos com o mesmo nome

Valores retornados

• sucesso
  Booleano; retorna true em caso de sucesso e false em caso de falha.
• mensagem de erro
  Texto; mensagem de erro em caso de falha.

Observações

Move um arquivo ou diretório de caminho_de_origem para caminho_de_destino; renomear no mesmo caminho também é considerado uma movimentação.
Palavras-chave: renomear arquivo, renomear diretório, renomear pasta, mover arquivo, mover diretório, mover pasta.
Disponível somente em versões posteriores a 20250313.

Exemplo

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

Observação: o código acima usa a função sys.alert, que não pertence a este capítulo.