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

Примеры

свернуть все

Копирование файла в другую папку

Скрипт Open Live Script

Скопируйте myfile1.m от текущей папки до подпапки myFolder.

mkdir myFolder
copyfile myfile1.m myFolder

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

Скрипт Open Live Script

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

copyfile myfile1.m myfile2.m

Копирование файлов и папки к новой папке

Скрипт Open Live Script

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

copyfile my* newFolder

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

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

Примечание

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

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

свернуть все

`status` — Состояние Copy
0 | 1

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

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

`msg` — Сообщение об ошибке
символьный вектор

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

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

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

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

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

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

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

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

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

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

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

Результат копии независим от платформы: 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 копии только содержимое исходной папки: При копировании непустой папки в папку символьной ссылки, copyfile теперь копирует содержимое исходной папки (то есть, файлы и папки в исходной папке), а не целой исходной папке. Точно так же при копировании папки символьной ссылки в папку назначения, только содержимое папки символьной ссылки копируется.

Например, рассмотрите структуру папок на 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` — Состояние Copy
0 | 1

`msg` — Сообщение об ошибке
символьный вектор

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

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

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

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

Смотрите также

Темы

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

Поддержка

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

copyfile

Синтаксис

Описание

Примеры

Копирование файла в другую папку

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

Копирование файлов и папки к новой папке

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

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

source — Файл или папка, чтобы скопировать вектор символов | строковый скаляр

destination — Файл или место назначения папки вектор символов | строковый скаляр

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

status — Состояние Copy 0 | 1

msg — Сообщение об ошибке символьный вектор

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

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

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

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

Смотрите также

Темы

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

Поддержка

`source` — Файл или папка, чтобы скопировать
вектор символов | строковый скаляр

`destination` — Файл или место назначения папки
вектор символов | строковый скаляр

`status` — Состояние Copy
0 | 1

`msg` — Сообщение об ошибке
символьный вектор

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

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