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 является удаленным, это должно содержать полный путь, заданный как 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 платформы совпадают только с файлами, которые имеют расширение