movefile

Переместите или переименуйте файл или папку

Синтаксис

movefile source
movefile source destination
movefile source destination f
status = movefile(___)
[status,msg] = movefile(___)
[status,msg,msgID] = 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 является строкой, заключите все входные параметры в круглые скобки. Например, movefile("myfile.m","newfolder").

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

Примечание

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

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

свернуть все

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

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

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

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

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