std::filesystem::create_directory, std::filesystem::create_directories

在头文件 `<filesystem>` 中定义
bool create_directory( const std::filesystem::path& p );	(1)	(自 C++17)
bool create_directory( const std::filesystem::path& p, std::error_code& ec ) noexcept;	(2)	(自 C++17)
bool create_directory( const std::filesystem::path& p, const std::filesystem::path& existing_p );	(3)	(自 C++17)
bool create_directory( const std::filesystem::path& p, const std::filesystem::path& existing_p, std::error_code& ec ) noexcept;	(4)	(自 C++17)
bool create_directories( const std::filesystem::path& p );	(5)	(自 C++17)
bool create_directories( const std::filesystem::path& p, std::error_code& ec );	(6)	(自 C++17)

1,2) 创建目录 p，如同使用 POSIX mkdir()，第二个参数为 static_cast<int>(std::filesystem::perms::all)（父目录必须已经存在）。如果函数由于 p 解析为现有目录而失败，则不会报告错误。否则，如果失败，则报告错误。

3,4) 与 (1,2) 相同，只是新目录的属性从 existing_p（必须是存在的目录）复制。哪些属性被复制是与操作系统相关的：在 POSIX 系统上，属性被复制，如同使用

stat(existing_p.c_str(), &attributes_stat)
mkdir(p.c_str(), attributes_stat.st_mode)

在 Windows 操作系统上，不会复制 existing_p 的任何属性。

5,6) 对 p 的每个不存在的元素执行 (1,2)。如果 p 已经存在，则函数不执行任何操作（此条件不被视为错误）。

[编辑] 参数

p	-	要创建的新目录的路径
existing_p	-	要从中复制属性的目录的路径
ec	-	非抛出重载中用于错误报告的输出参数

[编辑] 返回值

如果为目录 p 解析的目录新创建了一个目录，则为 true，否则为 false。

[编辑] 异常

任何未标记为 noexcept 的重载在内存分配失败时可能会抛出 std::bad_alloc。

1,5) 在底层操作系统 API 错误上抛出 std::filesystem::filesystem_error，使用 p 作为第一个路径参数，并使用操作系统错误代码作为错误代码参数进行构造。

2,6) 如果操作系统 API 调用失败，则将 std::error_code& 参数设置为操作系统 API 错误代码，如果未发生错误，则执行 ec.clear()。

3) 在底层操作系统 API 错误上抛出 std::filesystem::filesystem_error，使用 p 作为第一个路径参数，existing_p 作为第二个路径参数，并使用操作系统错误代码作为错误代码参数进行构造。

4) 如果操作系统 API 调用失败，则将 std::error_code& 参数设置为操作系统 API 错误代码，如果未发生错误，则执行 ec.clear()。

[编辑] 备注

属性保留重载 (3,4) 在递归复制目录时会被 copy() 隐式调用。它在 boost.filesystem 中的等效项是 copy_directory（参数顺序相反）。

[编辑] 示例

运行此代码

#include <cassert>
#include <cstdlib>
#include <filesystem>
 
int main()
{
    std::filesystem::current_path(std::filesystem::temp_directory_path());
 
    // Basic usage
    std::filesystem::create_directories("sandbox/1/2/a");
    std::filesystem::create_directory("sandbox/1/2/b");
 
    // Directory already exists (false returned, no error)
    assert(!std::filesystem::create_directory("sandbox/1/2/b"));
 
    // Permissions copying usage
    std::filesystem::permissions(
        "sandbox/1/2/b",
        std::filesystem::perms::others_all,
        std::filesystem::perm_options::remove
    );
    std::filesystem::create_directory("sandbox/1/2/c", "sandbox/1/2/b");
 
    std::system("ls -l sandbox/1/2");
    std::system("tree sandbox");
    std::filesystem::remove_all("sandbox");
}

可能的输出

drwxr-xr-x 2 user group 4096 Apr 15 09:33 a
drwxr-x--- 2 user group 4096 Apr 15 09:33 b
drwxr-x--- 2 user group 4096 Apr 15 09:33 c
sandbox
└── 1
    └── 2
        ├── a
        ├── b
        └── c

[编辑] 缺陷报告

以下行为变更缺陷报告被追溯应用于之前发布的 C++ 标准。

DR	应用于	发布的行为	正确行为
LWG 2935	C++17	如果目标已存在但不是目录，则会发生错误	没有错误
LWG 3014	C++17	`create_directories` 的 `error_code` 重载标记为 noexcept 但可以分配内存	noexcept 已移除
P1164R1	C++17	由现有非目录文件导致的创建失败不是错误	已改为错误

[编辑] 另请参阅

create_symlinkcreate_directory_symlink (C++17)(C++17)	创建符号链接 (函数) [编辑]
copy (C++17)	复制文件或目录 (函数) [编辑]
权限 (C++17)	标识文件系统权限 (枚举) [编辑]

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作