std::filesystem::copy_options

C++ 参考手册

位置：首页 > C++ 参考手册 >文件系统库 > std::filesystem::copy_options

定义于头文件 `<filesystem>`
enum class copy_options { none = /* unspecified /, skip_existing = / unspecified /, overwrite_existing = / unspecified /, update_existing = / unspecified /, recursive = / unspecified /, copy_symlinks = / unspecified /, skip_symlinks = / unspecified /, directories_only = / unspecified /, create_symlinks = / unspecified /, create_hard_links = / unspecified */ };		(C++17 起)

此类型代表控制 copy() 及 copy_file() 函数行为的可用选项。

copy_options 满足位掩码类型 (BitmaskType) 的要求（表示位运算符 operator& 、 operator| 、 operator^ 、 operator~ 、 operator&= 、 operator|= 及 operator^= 对此类型定义）。 none 代表空位掩码；每个其他枚举项都代表有别的位掩码元素。

成员常量

每个下列选项组中至多存在一个选项，否则复制函数的行为未定义。

成员常量	含义
文件已存在时控制 `copy_file()` 的选项
`none`	报告错误（默认行为）
`skip_existing`	保持既存文件，而不报告错误。
`overwrite_existing`	替换既存文件。
`update_existing`	替换既存文件，仅若它旧于被复制的文件
在子目录上控制 `copy()` 效果的选项
`none`	跳过子目录（默认行为）
`recursive`	递归地复制子目录及其内容
在符号链接上控制 `copy()` 效果的选项
`none`	跟随符号链接（默认行为）
`copy_symlinks`	复制符号链接为符号链接，而非其所指的文件
`skip_symlinks`	忽略符号链接
控制 `copy()` 所做的复制类型的选项
`none`	复制文件内容（默认行为）
`directories_only`	复制目录结构，但不复制任何非目录文件
`create_symlinks`	创建指向原有文件的符号链接，而不创建文件副本。注意：源路径必须是绝对路径，除非目标路径在当前目录中。
`create_hard_links`	创建解析到与原有文件相同文件的硬链接，而不创建文件副本

示例

运行此代码

#include <iostream>
#include <fstream>
#include <filesystem>
namespace fs = std::filesystem;
 
int main()
{
    fs::create_directories("sandbox/dir/subdir");
    std::ofstream("sandbox/file1.txt").put('a');
    fs::copy("sandbox/file1.txt", "sandbox/file2.txt"); // 复制文件
    fs::copy("sandbox/dir", "sandbox/dir2"); // 复制目录（非递归）
    // sandbox 保有 2 个文件及 2 个目录，其中之一拥有子目录
    // sandbox/file1.txt
    // sandbox/file2.txt
    // sandbox/dir2
    // sandbox/dir
    //    sandbox/dir/subdir
    fs::copy("sandbox", "sandbox/copy", fs::copy_options::recursive);
    // sandbox/copy 保有上述文件和子目录的副本
    fs::remove_all("sandbox");
}

参阅

copy (C++17)	复制文件或目录 (函数)
copy_file (C++17)	复制文件内容 (函数)