copyfile

Скопируйте файл или папку

Описание

copyfile source копирует файл или папку source к текущей папке. После успешного copyfile операция, метка времени для нового файла совпадает с меткой времени для source.

пример

copyfile source destination копии source к файлу или папке destination.

  • Если source файл, затем destination может быть файл или папка.

  • Если source папка, затем destination должна быть папка.

  • Если source папка или задает несколько файлов и destination не существует, затем copyfile попытки создать destination.

пример

copyfile source destination f копии source к destination, даже когда destination не перезаписываемо. Состояние чтения-записи приписывает для destination не изменяется.

пример

status = copyfile(___) копирует заданный файл или папку и возвращает состояние 1 если операция успешна. В противном случае, copyfile возвращает 0. Можно использовать этот синтаксис с любой из комбинаций входных аргументов в предыдущих синтаксисах.

пример

[status,msg] = copyfile(___) также возвращает текст сообщения для любого предупреждения или ошибки, которая происходит.

пример

[status,msg,msgID] = copyfile(___) дополнительно возвращает идентификатор сообщения для любого предупреждения или ошибки, которая происходит.

Примеры

свернуть все

Скопируйте myfile1.m от текущей папки до подпапки myFolder.

mkdir myFolder
copyfile myfile1.m myFolder

Создайте копию myfile1.m в текущей папке, присваивая его имя myfile2.m.

copyfile myfile1.m myfile2.m

Скопируйте файлы и подпапки с именами, начинающимися с my от текущей папки до папки newFolder, где newFolder уже не существует.

copyfile my* newFolder

Скопируйте файл myfile1.m от текущей папки до папки restricted только для чтения.

Создайте папку restricted только для чтения.

mkdir restricted
fileattrib restricted -w

Скопируйте и переименуйте файл myfile1.m. Состояние 0 показывает, что копия была неудачна.

status = copyfile('myfile1.m', 'restricted');
status
status = logical
   0

Скопируйте файл myfile1.m использование 'f' опции, чтобы заменить состояние только для чтения папки назначения. Состояние 1 и пустой message и messageId подтвердите, что копия была успешна.

[status,message,messageId] = copyfile('myfile1.m', 'restricted', 'f');
status
status = logical
   1

message
message =

  0x0 empty char array
messageId
messageId =

  0x0 empty char array

Входные параметры

свернуть все

Файл или папка, чтобы скопировать, заданный как вектор символов или представить скаляр в виде строки. source может быть абсолютный или относительный путь. Чтобы скопировать несколько файлов или папок, используйте подстановочные знаки (*).

Примечание

Если source строка, заключите все входные параметры в круглые скобки. Например, movefile("myfile.m","newfolder").

Файл или место назначения папки, заданное как вектор символов или скаляр строки. destination может быть абсолютный или относительный путь, но не может включать подстановочные знаки.

Примечание

Если destination строка, заключите все входные параметры в круглые скобки. Например, movefile("myfile.m","newfolder").

Выходные аргументы

свернуть все

Скопируйте состояние, указав, успешна ли попытка переместить файл или папку, возвращенная как 0 или 1. Если попытка успешна, значение status 1. В противном случае значение 0.

Типы данных: логический

Сообщение об ошибке, возвращенное как вектор символов. Если ошибка или предупреждение происходят, msg содержит текст сообщения ошибки или предупреждения. В противном случае, msg isempty.

Идентификатор сообщения об ошибке, возвращенный как вектор символов. Если ошибка или предупреждение происходят, msgID содержит идентификатор сообщения ошибки или предупреждения. В противном случае, msgID isempty.

Представлено до R2006a