movefile

Move ou renomeia um arquivo ou pasta.

Categoria: Programming > Files and Folders

Sintaxe

movefile(source, destination)

[status, message, messageid] = movefile(___)

Descrição

Mover dentro de um mesmo disco equivale a renomear, o que é rápido e mantém o conteúdo intacto. Se destination é uma pasta existente, o item mantém o nome dentro dela; caso contrário, assume o novo nome, que é como um arquivo é renomeado.

A origem deixa de existir após uma movimentação bem-sucedida. Para mantê-la, use copyfile.

Argumentos de entrada

source

Arquivo, pasta ou padrão com curinga.

destination

Novo nome, ou pasta existente para onde mover.

Argumentos de saída

status

true quando a movimentação deu certo.

message

Texto que descreve o problema; vazio em caso de sucesso.

messageid

Identificador da mensagem; vazio em caso de sucesso.

Exemplo

Renomeando e depois movendo para uma pasta

writelines('v1', 'draft.txt');
mkdir archive
movefile('draft.txt', 'final.txt');
movefile('final.txt', 'archive');
[isfile('draft.txt'), isfile('final.txt'), isfile('archive/final.txt')]

ans = 1×3 logical array

   0   0   1

Veja também

copyfile delete mkdir dir