Exponenta Banner

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(___) дополнительно возвращает идентификатор сообщения для любого предупреждения или ошибки.

Примеры

свернуть все

Открыть Live Script

Копировать myfile1.m из текущей папки в подпапку myFolder.

mkdir myFolder
copyfile myfile1.m myFolder
Открыть Live Script

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

copyfile myfile1.m myfile2.m
Открыть Live Script

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

copyfile my* newFolder
Открыть Live Script

Скопируйте файл 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

Поддержка