Main Content

copyfile

复制文件或文件夹

说明

copyfile source 将文件或文件夹 source 复制到当前文件夹中。成功执行 copyfile 操作后,新文件的时间戳与 source 的时间戳相同。

示例

copyfile source destinationsource 复制到文件或文件夹 destination

  • 如果 source 是文件,则 destination 可以是文件或文件夹。

  • 如果 source 是文件夹,则 destination 必须是文件夹。

  • 如果 source 是文件夹或指定了多个文件,而 destination 不存在,则 copyfile 将尝试创建 destination

示例

copyfile source destination fsource 复制到 destination,即使 destination 不可写也是如此。destination 的读/写属性的状态不会更改。

示例

status = copyfile(___) 会复制指定的文件或文件夹,如果操作成功,则返回 1 的状态。否则,copyfile 将返回 0。您可以将此语法与上述语法中的任何输入参数结合使用。

示例

[status,msg] = copyfile(___) 还返回发生的任何警告或错误的消息文本。

示例

[status,msg,msgID] = copyfile(___) 还返回发生的任何警告或错误的消息 ID。

示例

全部折叠

myfile1.m 从当前文件夹复制到子文件夹 myFolder 中。

mkdir myFolder
copyfile myfile1.m myFolder

在当前文件夹中创建 myfile1.m 的副本,并为其指定名称 myfile2.m

copyfile myfile1.m myfile2.m

将名称以 my 开头的文件和子文件夹从当前文件夹复制到文件夹 newFolder 中,而 newFolder 尚不存在。

copyfile my* newFolder

将文件 myfile1.m 从当前文件夹复制到只读文件夹 restricted 中。

创建只读文件夹 restricted

mkdir restricted
fileattrib restricted -w

复制并重命名文件 myfile1.m。状态 0 表明复制失败。

status = copyfile('myfile1.m', 'restricted');
status
status = logical
   0

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

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

message
message =

  0x0 empty char array
messageId
messageId =

  0x0 empty char array

输入参数

全部折叠

要复制的文件或文件夹,指定为字符向量或字符串标量。要复制多个文件或文件夹,请使用通配符 (*)。

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

注意

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

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

如果 destination 是本地位置,则可以将其指定为绝对路径或相对路径。如果在 destination 中指定的文件夹不存在,copyfile 将创建这些文件夹。如果 destination 是远程位置,它必须包含指定为 URL 的完整路径。有关详细信息,请参阅处理远程数据

注意

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

输出参数

全部折叠

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

数据类型: logical

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

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

版本历史记录

在 R2006a 之前推出

全部展开

R2020a 中的行为有变化

R2020a 中的行为有变化