copyfile

复制文件或文件夹

全页折叠

语法

copyfile source

copyfile source destination

copyfile source destination f

status = copyfile(___)

[status,msg] = copyfile(___)

[status,msg,msgID] = copyfile(___)

说明

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

copyfile source destination 将 source 复制到文件或文件夹 destination。

如果 source 是文件，则 destination 可以是文件或文件夹。
如果 source 是文件夹，则 destination 必须是文件夹。
如果 source 是文件夹或指定了多个文件，而 destination 不存在，则 copyfile 将尝试创建 destination。

示例

copyfile source destination f 将 source 复制到 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 且 message 和 messageId 为空确认复制成功。

[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 可以是绝对路径或相对路径。不过，要复制远程位置的文件和文件夹，source 必须包含指定为统一资源定位器 (URL) 的完整路径。有关详细信息，请参阅处理远程数据。

注意

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

`destination` — 文件或文件夹目标
字符向量 | 字符串标量

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

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

注意

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

输出参量

全部折叠

`status` — 复制状态
0 | 1

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

数据类型: logical

`msg` — 错误消息
字符向量

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

`msgID` — 错误消息标识符
字符向量

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

扩展功能

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

copyfile 函数不支持通配符运算或 URL 作为输入。
从 MATLAB^® 生成的代码的执行行为可能与其在 MATLAB 中不同。
在这种情况下，生成代码中的文件处理类似于 Windows^® 平台上的 CopyFileExA 函数，或 UNIX^® 系统上 C 语言中的 read 和 write 函数。

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

版本历史记录

在 R2006a 之前推出

全部展开

R2020a: UNIX 平台上的通配符表达式 `.` 仅匹配具有扩展名的文件

从 R2020a 开始，在 UNIX 平台上，通配符表达式 *.* 不再匹配文件夹或没有扩展名的文件。在以前的版本中，该表达式可匹配文件夹或文件，无论扩展名是什么都可以，包括没有扩展名的文件。此行为更改不适用于 Microsoft^® Windows 平台。

R2020a: 在不同的平台和文件系统上以一致的方式处理符号链接

符号链接（简称 symlink）是指向目标文件或文件夹的文件系统对象。从 R2020a 开始，当对符号链接文件或文件夹进行操作时，copyfile 函数的行为会发生变化。

复制结果与平台无关：copyfile 现在以相同的方式处理不同操作系统上的符号链接。例如，假设某个文件夹结构包含一个 myFile.m 文件和一个指向 myFile.m 的符号链接（指定为 symlinkToMyFile）。
```
myFile.m
symlinkToMyFile
```
从 R2020a 开始，copyfile('symlinkToMyFile','newFile') 将符号链接的目标（即 myFile.m）复制到目标位置。在以前的版本中，在 Linux^® 上，copyfile 会复制符号链接。
平台 newFile（从 R2020a 开始） newFile（R2019b 及更早版本）
Linux
myFile.m

symlinkToMyFile
Mac
myFile.m

myFile.m
Windows
myFile.m

myFile.m

平台	`newFile`（从 R2020a 开始）	`newFile`（R2019b 及更早版本）
Linux	myFile.m	symlinkToMyFile
Mac	myFile.m	myFile.m
Windows	myFile.m	myFile.m

copyfile 仅复制源文件夹的内容：将非空文件夹复制到符号链接文件夹时，copyfile 现在会复制源文件夹的内容（即源文件夹中的文件和文件夹），而不是整个源文件夹。同样，将符号链接文件夹复制到目标文件夹时，将仅复制符号链接文件夹的内容。

例如，假设 Linux 上有一个文件夹结构，它包含一个非空文件夹 myFolder 和一个指向该文件夹的名为 symlinkToMyFolder 的符号链接。下表显示在不同 MATLAB 版本中执行 copyfile('myFolder','simlinkToMyFolder') 后的文件夹结构。

复制前的文件夹结构	复制后的文件夹结构（从 R2020a 开始）	复制后的文件夹结构（R2019b 及更早版本）
myFolder myFile.m symlinkToMyFolder	myFolder myFile.m symlinkToMyFolder myFile.m	myFolder myFile.m symlinkToMyFolder myFolder myFile.m

另请参阅

copyfile

语法

说明

示例

将文件复制到另一文件夹

在当前文件夹中创建文件副本

将文件和文件夹复制到新文件夹中

将文件复制到只读文件夹中

输入参数

source — 要复制的文件或文件夹 字符向量 | 字符串标量

destination — 文件或文件夹目标 字符向量 | 字符串标量

输出参量

status — 复制状态 0 | 1

msg — 错误消息 字符向量

msgID — 错误消息标识符 字符向量

扩展功能

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

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

版本历史记录

R2020a: UNIX 平台上的通配符表达式 *.* 仅匹配具有扩展名的文件

R2020a: 在不同的平台和文件系统上以一致的方式处理符号链接

另请参阅

主题

WeChat

`source` — 要复制的文件或文件夹
字符向量 | 字符串标量

`destination` — 文件或文件夹目标
字符向量 | 字符串标量

`status` — 复制状态
0 | 1

`msg` — 错误消息
字符向量

`msgID` — 错误消息标识符
字符向量

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

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

R2020a: UNIX 平台上的通配符表达式 `.` 仅匹配具有扩展名的文件