v1.0
Comando

MoveFile()

Move um arquivo para outro caminho (equivale a recortar e colar). Suporta wildcard para mover múltiplos arquivos. Cria o diretório de destino automaticamente se não existir.
Sintaxe
MoveFile(origem, destino [, sobrescrever])

Parâmetros

ParâmetroObrigatórioDescrição
origemSimCaminho completo do arquivo a mover. Aceita wildcard * para mover múltiplos arquivos.
destinoSimCaminho de destino. Pode ser:
• Caminho completo do arquivo: @'C:\processado\dados.xlsx'
• Pasta de destino (terminar com \): @'C:\processado\' — o nome do arquivo original é preservado.
sobrescreverNãoTrue: sobrescreve o arquivo de destino se já existir. False (padrão): não sobrescreve.

Exemplos

AthusScript
// Mover arquivo para outra pasta:
MoveFile(@'C:\entrada\dados.csv', @'C:\processado\')

// Mover e renomear:
MoveFile(@'C:\temp\saida.pdf', @'C:\final\relatorio_2024.pdf')

// Mover com sobrescrita:
MoveFile(@'C:\temp\relatorio.pdf', @'C:\final\relatorio.pdf', True)

// Mover múltiplos arquivos:
MoveFile(@'C:\entrada\*.csv', @'C:\processado\')

Observações

Se a origem não existir, o arquivo é ignorado silenciosamente. Com wildcard, move todos os arquivos correspondentes para a pasta de destino. O diretório de destino é criado automaticamente se não existir.