Main Content

movefile

移动或重命名文件或文件夹

说明

示例

movefile sourcesource 文件或文件夹移动到当前文件夹中。movefile 不会保留 source 的存档属性。

示例

movefile source destinationsource 文件或文件夹移动到 destination。如果 sourcedestination 位于同一位置,则 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(___) 还返回发生的任何警告或错误的消息 ID。

示例

全部折叠

通过省略输入目标位置,将文件和文件夹移动到当前文件夹。

创建两个文件夹:第一个 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 开头的文件和子文件夹从当前文件夹移动到文件夹 newFoldernewFolder 之前并不存在)。

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

使用 'f' 选项移动文件 myfile1.m,以覆盖目标文件夹的只读状态。状态为 1 且 messagemessageID 为空确认复制成功。

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

输出参数

全部折叠

移动状态,指示尝试移动文件或文件夹是否成功,返回 01。如果成功,则 status 的值为 1。否则,值为 0。

数据类型: logical

错误消息,以字符向量形式返回。如果发生错误或警告,msg 将包含错误或警告的消息文本。否则,msg 为空,即 ''

错误消息标识符,以字符向量形式返回。如果发生错误或警告,msgID 将包含错误或警告的消息标识符。否则,msgID 为空,即 ''

版本历史记录

在 R2006a 之前推出

全部展开

R2020a 中的行为有变化