std::filesystem::copy_options
< cpp | filesystem
定义于头文件 <filesystem>
|
||
enum class copy_options { none = /* 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 <cstdlib> #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"); // 复制目录(非递归) const auto copyOptions = fs::copy_options::update_existing | fs::copy_options::recursive | fs::copy_options::directories_only ; fs::copy("sandbox", "sandbox_copy", copyOptions); static_cast<void>(std::system("tree")); fs::remove_all("sandbox"); fs::remove_all("sandbox_copy"); }
可能的输出:
. ├── sandbox │ ├── dir │ │ └── subdir │ ├── dir2 │ ├── file1.txt │ └── file2.txt └── sandbox_copy ├── dir │ └── subdir └── dir2 8 directories, 2 files
参阅
(C++17) |
复制文件或目录 (函数) |
(C++17) |
复制文件内容 (函数) |