movefile

R2026b

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

全页折叠

语法

movefile source
movefile source destination
movefile source destination f
movefile(source,destination,MoveLinkBehavior=slbehavior)
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 的读/写属性的状态不会更改。此语法会覆盖只读文件。

示例

movefile(source,destination,MoveLinkBehavior=slbehavior) 指定是移动符号链接还是其目标。 (自 R2024b 起)

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 开头的文件和子文件夹从当前文件夹移动到文件夹 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

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

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


message
message =

  0×0 empty char array

messageId
messageId =

  0×0 empty char array

输入参数

全部折叠

要移动的文件或文件夹，指定为字符向量或字符串标量。要移动多个文件或文件夹，请使用通配符 (*)。在移动多个文件或文件夹时，movefile 只移动可以移动的文件和文件夹。

在移动本地文件或文件夹时，source 可以是绝对路径或相对路径。不过，要移动远程位置的文件和文件夹，source 必须包含指定为统一资源定位器 (URL) 的完整路径。有关详细信息，请参阅处理远程数据。

注意

如果 source 是字符串，请将所有输入都括在圆括号中。例如，movefile("myfile.m","newfolder")。

文件或文件夹目标，指定为字符向量或字符串标量。destination 不能包含通配符 (*)。

如果 destination 是本地位置，则可以将其指定为绝对路径或相对路径。如果 destination 是远程位置，它必须包含指定为 URL 的完整路径。有关详细信息，请参阅处理远程数据。

注意

如果 destination 是字符串，请将所有输入都括在圆括号中。例如，movefile("myfile.m","newfolder")。

自 R2024b 起

符号链接行为，指定为以下值之一：

  • "preserve" - 移动符号链接，并在目标位置将其保留为符号链接。符号链接的目标保持不变。

  • "resolve" - 移动符号链接的目标。

输出参量

全部折叠

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

数据类型: logical

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

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

提示

  • 此函数支持 Microsoft® Windows® 快捷方式文件 (.lnk)。

扩展功能

全部展开

基于线程的环境
使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

函数

主题