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 должен содержать полный путь, заданный как универсальный локатор ресурса (URL). Для получения дополнительной информации смотрите работу с Удаленными данными.

Примечание

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

Файл или место назначения папки в виде вектора символов или строкового скаляра. destination не может включать подстановочные знаки (*).

Если destination местное расположение, оно может быть задано как абсолютный или относительный путь. Если destination является удаленным, это должно содержать полный путь, заданный как URL. Для получения дополнительной информации смотрите работу с Удаленными данными.

Примечание

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

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

свернуть все

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

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

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

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

Вопросы совместимости

развернуть все

Поведение изменяется в R2020a

Поведение изменяется в R2020a

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