| Classes | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| File types | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <filesystem> | ||
bool create_directory(conststd::filesystem::path& p); | (1) | (since C++17) |
bool create_directory(conststd::filesystem::path& p,std::error_code& ec)noexcept; | (2) | (since C++17) |
bool create_directory(conststd::filesystem::path& p, conststd::filesystem::path& existing_p); | (3) | (since C++17) |
bool create_directory(conststd::filesystem::path& p, conststd::filesystem::path& existing_p, | (4) | (since C++17) |
bool create_directories(conststd::filesystem::path& p); | (5) | (since C++17) |
bool create_directories(conststd::filesystem::path& p,std::error_code& ec); | (6) | (since C++17) |
mkdir() with a second argument ofstatic_cast<int>(std::filesystem::perms::all) (the parent directory must already exist). If the function fails becausep resolves to an existing directory, no error is reported. Otherwise on failure an error is reported.stat(existing_p.c_str(),&attributes_stat)mkdir(p.c_str(), attributes_stat.st_mode)
Contents |
| p | - | the path to the new directory to create |
| existing_p | - | the path to a directory to copy the attributes from |
| ec | - | out-parameter for error reporting in the non-throwing overload |
true if a directory was newly created for the directoryp resolves to,false otherwise.
Any overload not markednoexcept may throwstd::bad_alloc if memory allocation fails.
The attribute-preserving overload(3,4) is implicitly invoked bycopy() when recursively copying directories. Its equivalent in boost.filesystem iscopy_directory (with argument order reversed).
#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 usagestd::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");}
Possible output:
drwxr-xr-x 2 user group 4096 Apr 15 09:33 adrwxr-x--- 2 user group 4096 Apr 15 09:33 bdrwxr-x--- 2 user group 4096 Apr 15 09:33 csandbox└── 1 └── 2 ├── a ├── b └── c
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2935 | C++17 | error if target already exists but is not a directory | not error |
| LWG 3014 | C++17 | error_code overload ofcreate_directories marked noexcept but can allocate memory | noexcept removed |
| P1164R1 | C++17 | creation failure caused by an existing non-directory file is not an error | made error |
(C++17)(C++17) | creates a symbolic link (function)[edit] |
(C++17) | copies files or directories (function)[edit] |
(C++17) | identifies file system permissions (enum)[edit] |
