Pular para o conteúdo principal

Copiar um arquivo ou diretório (file.copy)

Declaração​

sucesso, mensagem_de_erro = file.copy(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 cópia:
    • 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​

Copia um arquivo ou diretório de caminho_de_origem para caminho_de_destino.
Palavras-chave: copiar arquivo, copiar diretório, copiar pasta.
Disponível somente em versões posteriores a 20250313.

Exemplo​

ok, err = file.copy(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.