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");
}


参阅

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