`copyfile`

Copia um arquivo ou uma pasta.

Categoria: Programming > Files and Folders

Sintaxe

copyfile(source, destination)

Copia source para destination.

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

Retorna um sinalizador de status e uma mensagem que descreve o resultado.

Descrição

Quando source é um arquivo e destination é uma pasta existente, o arquivo mantém o nome dentro dela; quando destination é um nome novo, a cópia recebe esse nome. Uma origem com curinga copia todas as correspondências, e o destino deve então ser uma pasta. Uma pasta de origem é copiada com todo o conteúdo.

Sem argumentos de saída, uma falha é um erro; com eles, o resultado é informado em status e message.

Argumentos de entrada

source: Arquivo, pasta ou padrão com curinga, como '*.txt'.
destination: Nome do arquivo de destino ou pasta existente.

Argumentos de saída

status: true quando a cópia deu certo.
message: Texto que descreve o problema, vazio em caso de sucesso.
messageid: Identificador da mensagem, vazio em caso de sucesso.

Exemplo

Copiando para um novo nome e para uma pasta

writelines(["alpha"; "beta"], 'a.txt');
[ok, msg] = copyfile('a.txt', 'b.txt')
mkdir backup
copyfile('a.txt', 'backup');
isfile('backup/a.txt')

Saída

ok = logical
   1
msg = 0×0 empty char array
ans = logical
   1

Observações

Quando a origem não corresponde a nada, o MatLivre gera o erro No matching files were found. mesmo com argumentos de saída pedidos, enquanto o MATLAB retorna status falso.

Veja também

movefile delete mkdir dir isfile