copyfile

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

Синтаксис

copyfile source
copyfile source destination
copyfile source destination f
status = copyfile(___)
[status,msg] = copyfile(___)
[status,msg,msgID] = 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 пуст, ''.

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

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

Для просмотра документации необходимо авторизоваться на сайте