Exponenta Banner
exponenta event banner

copyfile

Копировать файл или папку

свернуть все на странице

Синтаксис

источник файла копирайта
исходный адрес файла копирайта
исходный пункт назначения файла копированияf
status = файл копирайта (___)
[status, msg] = файл копирования (___)
[status, msg, msgID] = файл копирования (___)

Описание

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.

Типы данных: logical

Сообщение об ошибке, возвращенное в виде символьного вектора. При возникновении ошибки или предупреждения msg содержит текст сообщения об ошибке или предупреждения. В противном случае msg пуст, ''.

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

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

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

В R2020a изменилось поведение

В R2020a изменилось поведение

См. также

| | | | |

Темы

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

Документация MATLAB

Поддержка