copyfile

复制文件或文件夹

全页折叠

语法

copyfile source

copyfile source destination

copyfile source destination f

copyfile(source,destination,CopyLinkBehavior=slbehavior)

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 的读/写属性的状态不会更改。

示例

copyfile(source,destination,CopyLinkBehavior=slbehavior) 指定是复制符号链接还是其目标。 (自 R2024b 起)

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 =

  0×0 empty char array

messageId

messageId =

  0×0 empty char array

输入参数

全部折叠

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

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

在复制本地文件或文件夹时，source 可以是绝对路径或相对路径。但是，对于位于远程位置的文件和文件夹，您必须将完整路径指定为统一资源定位器 (URL)。Internet URL 必须包含协议类型 "http://" 或 "https://"。有关详细信息，请参阅处理远程数据。

注意

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

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

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

如果 destination 是本地位置，则可以指定绝对或相对路径。如果 source 是文件夹且 destination 文件夹不存在，copyfile 将创建该文件夹。如果 source 是文件且 destination 文件夹不存在，copyfile 将使用文件夹名称创建文件，无扩展名。要将文件写入目标文件夹，该文件夹必须预先存在。

如果 destination 是远程位置，则必须指定 URL 的完整路径。有关详细信息，请参阅处理远程数据。

注意

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

`slbehavior` — 符号链接行为
`"osdefault"` (默认) | `"preserve"` | `"resolve"`

自 R2024b 起

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

"osdefault" - 使用文件系统的默认行为。
"preserve" - 复制符号链接，并在目标位置将其保留为符号链接。符号链接的目标保持不变。
"resolve" - 复制符号链接的目标。

输出参量

全部折叠

`status` — 复制状态
0 | 1

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

数据类型: logical

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

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

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

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

局限性

MATLAB^® 不支持要求身份验证的 Internet URL。
MATLAB Online™ 支持与 Microsoft^® OneDrive™ 文件和文件夹相关联的 Internet URL，而 MATLAB 的安装版本仅支持本地 OneDrive 文件。

提示

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

扩展功能

全部展开

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

用法说明和限制：

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

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

版本历史记录

在 R2006a 之前推出

全部展开

R2024b: 使用文件操作函数通过 HTTP 和 HTTPS 读取数据

通过在 Internet URL 上执行文件读取操作，您可以从主要在线数据源读取数据。

R2024b: 使用符号链接来操作文件和文件夹

您可以使用符号链接复制文件和文件夹。将符号链接指定为数据源时，您可以控制是复制符号链接本身还是复制其目标。

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

另请参阅

函数

cd | delete | dir | mkdir | movefile | rmdir

copyfile

语法

说明

示例

将文件复制到另一文件夹

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

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

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

输入参数

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

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

slbehavior — 符号链接行为 "osdefault" (默认) | "preserve" | "resolve"

输出参量

status — 复制状态 0 | 1

msg — 错误消息 字符向量

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

局限性

提示

扩展功能

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

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

版本历史记录

R2024b: 使用文件操作函数通过 HTTP 和 HTTPS 读取数据

R2024b: 使用符号链接来操作文件和文件夹

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

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

另请参阅

函数

主题

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

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

`slbehavior` — 符号链接行为
`"osdefault"` (默认) | `"preserve"` | `"resolve"`

`status` — 复制状态
0 | 1

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

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

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

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

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