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

Примечание

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

`destination` - Конечный файл или папка
вектор символов | строковый скаляр

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

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

Примечание

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

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

свернуть все

`status` - Статус копирования
0 | 1

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

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

`msg` - Сообщение об ошибке
вектор символов

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

`msgID` - Идентификатор сообщения об ошибке
вектор символов

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

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

расширить все

Выражения подстановочных знаков `.` на платформах UNIX совпадает только с файлами с расширением

Поведение изменено в R2020a

Начиная с R2020a, на UNIX^® платформы, выражение подстановочного знака *.* больше не совпадает с папками или файлами без расширения. В предыдущих релизах выражение совпадает с папками или файлами независимо от расширения, включая файлы без расширения. Это изменение поведения не относится к Microsoft^® Windows^® платформы.

Символьные ссылки обрабатываются последовательно на платформах и файловых системах

Поведение изменено в R2020a

Символьные ссылки (или симлинки) являются файловыми системными объектами, которые указывают на целевые файлы или папки. Начиная с R2020a, поведение copyfile изменяется функция при работе с файлами или папками symlink.

Результат копирования является независимым от платформы: copyfile теперь одинаково относится к симлинкам в разных операционных системах. Например, рассмотрите структуру папки с файлом myFile.m и симлинк, указывающий на myFile.m, заданный как symlinkToMyFile.

myFile.m
symlinkToMyFile

Начиная с R2020a, copyfile('symlinkToMyFile','newFile') копирует цель симлинка (то есть myFile.m) в пункт назначения. В предыдущих релизах, на Linux^®, copyfile копирует вместо этого симлинк.

Платформа	`newFile` (Начиная с R2020a)	`newFile` (R2019b и более ранние версии)
Linux	myFile.m	symlinkToMyFile
Mac	myFile.m	myFile.m
Windows	myFile.m	myFile.m

copyfile копирует только содержимое исходной папки: При копировании непустой папки в папку symlink, copyfile теперь копирует содержимое исходной папки (то есть файлы и папки в исходной папке), а не всей исходной папки. Точно так же при копировании папки symlink в целевую папку копируется только содержимое папки symlink.

Например, рассмотрите структуру папки в Linux, состоящую из непустой папки myFolder и симлинк к этой папке с именем symlinkToMyFolder. В этой таблице показана структура папки после выполнения copyfile('myFolder','simlinkToMyFolder') в различных MATLAB^® релизы.

Структура папки перед копированием	Структура папки после копирования (начиная с R2020a)	Структура папки после копирования (R2019b и более ранние версии)
myFolder myFile.m symlinkToMyFolder	myFolder myFile.m symlinkToMyFolder myFile.m	myFolder myFile.m symlinkToMyFolder myFolder myFile.m

См. также

Темы

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

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

copyfile

Синтаксис

Описание

Примеры

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

Создайте копию файла в текущей папке

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

Копировать файл в папку только для чтения

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

`source` - Файл или папка для копирования
вектор символов | строковый скаляр

`destination` - Конечный файл или папка
вектор символов | строковый скаляр

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

`status` - Статус копирования
0 | 1

`msg` - Сообщение об ошибке
вектор символов

`msgID` - Идентификатор сообщения об ошибке
вектор символов

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

Выражения подстановочных знаков `.` на платформах UNIX совпадает только с файлами с расширением

Символьные ссылки обрабатываются последовательно на платформах и файловых системах

См. также

Темы

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

Поддержка

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

copyfile

Синтаксис

Описание

Примеры

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

Создайте копию файла в текущей папке

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

Копировать файл в папку только для чтения

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

source - Файл или папка для копирования вектор символов | строковый скаляр

destination - Конечный файл или папка вектор символов | строковый скаляр

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

status - Статус копирования 0 | 1

msg - Сообщение об ошибке вектор символов

msgID - Идентификатор сообщения об ошибке вектор символов

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

Выражения подстановочных знаков *.* на платформах UNIX совпадает только с файлами с расширением

Символьные ссылки обрабатываются последовательно на платформах и файловых системах

См. также

Темы

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

Поддержка

`source` - Файл или папка для копирования
вектор символов | строковый скаляр

`destination` - Конечный файл или папка
вектор символов | строковый скаляр

`status` - Статус копирования
0 | 1

`msg` - Сообщение об ошибке
вектор символов

`msgID` - Идентификатор сообщения об ошибке
вектор символов

Выражения подстановочных знаков `.` на платформах UNIX совпадает только с файлами с расширением