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").

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

свернуть все

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

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

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

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

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

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

Поведение изменяется в R2020a

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