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