exponenta event banner

movefile

Перемещение или переименование файла или папки

Описание

пример

movefile source перемещает файл или папку source в текущую папку. movefile не сохраняет атрибут архива source.

пример

movefile source destination шаги source в файл или папку destination. Если source и destination находятся в том же месте, затем movefile переименовывает source кому destination. Чтобы переименовать файл или папку при перемещении, сделайте destination другое имя от source и укажите только один файл или папку для source.

Если source является папкой, то destination должна быть папкой. Если source является папкой или может указывать несколько файлов и destination не существует, то movefile создает destination.

пример

movefile source destination f выполняет перемещение, даже когда destination не может быть записано. Состояние атрибута чтения/записи для destination не меняется.

пример

status = movefile(___) перемещает указанный файл или папку и возвращает состояние 1 если операция выполнена успешно. В противном случае movefile прибыль 0. Этот синтаксис можно использовать с любой комбинацией входных аргументов в предыдущих синтаксисах.

пример

[status,msg] = movefile(___) также возвращает текст сообщения для любого предупреждения или ошибки.

пример

[status,msg,msgID] = movefile(___) дополнительно возвращает идентификатор сообщения для любого предупреждения или ошибки.

Примеры

свернуть все

Переместите файлы и папки в текущую папку, пропустив конечный ввод.

Создайте две папки: первую, myfiles, содержащий файл myfile1.mи второе, myotherfiles, содержащий файл myfile2.m.

mkdir myfiles
movefile myfile1.m myfiles
mkdir myotherfiles
movefile myfile2.m myotherfiles

Двинуться myfile1.m в текущую папку. Поскольку место назначения не указано, MATLAB ® предполагает, что местом назначения является текущая папка.

movefile myfiles/myfile1.m

Установить текущую папку в значение myfiles. Двинуться myotherfiles и его содержимое в текущую папку.

cd myfiles
movefile ../myotherfiles

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

movefile my* newFolder

Создать папку myoldfolder, а затем переименовать его в mynewfolder.

mkdir myoldfolder
movefile myoldfolder mynewfolder

Переместить файл myfile1.m из текущей папки в папку только для чтения restricted.

Создать папку только для чтения restricted.

mkdir restricted
fileattrib restricted -w

Переместить файл myfile1.m. Состояние 0 показывает, что копия не была выполнена.

status = movefile('myfile1.m','restricted');
status
status = logical
   0

Переместить файл myfile1.m использование параметра «f» для переопределения состояния конечной папки, доступного только для чтения. Статус 1 и пустой message и messageID Подтверждение успешной копии.

[status,message,messageId] = movefile('myfile1.m','restricted','f');
status
status = logical
   1

message
message =

  0x0 empty char array
messageId
messageId =

  0x0 empty char array

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

свернуть все

Перемещаемый файл или папка, указанный как вектор символа или скаляр строки. Для перемещения нескольких файлов или папок используйте подстановочные знаки (*).

source может быть абсолютным или относительным путем при перемещении локальных файлов или папок. Однако для перемещения файлов и папок в удаленное расположение source должен содержать полный путь, указанный как унифицированный URL-адрес ресурса. Дополнительные сведения см. в разделе Работа с удаленными данными.

Примечание

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

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

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

Примечание

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

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

свернуть все

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

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

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

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

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

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

В R2020a изменилось поведение

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