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

Примеры

свернуть все

Скрипт 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 является строкой, заключите все входные параметры в круглые скобки. Например, movefile("myfile.m","newfolder").

Файл или место назначения папки, заданное как вектор символов или скаляр строки. destination может быть абсолютным или относительным путем, но не может включать подстановочные знаки.

Примечание

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

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

свернуть все

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

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

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

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

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

| | | | |

Темы

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

Документация MATLAB
Поддержка