CKTIS / C++
std::filesystem::create_directories: vytvoření celé adresářové cesty
std::filesystem::create_directories postupně vytvoří chybějící adresáře cesty a oznámí, zda vytvořila konečný adresář.
Verze: C++23
Syntaxe
bool std::filesystem::create_directories(const std::filesystem::path& p);
bool std::filesystem::create_directories(
const std::filesystem::path& p, std::error_code& ec);std::filesystem::create_directories(p) z <filesystem> provede ekvivalent create_directory pro každý neexistující prvek p. true vrátí jen tehdy, když vytvoří adresář určený celým p; pokud už existoval, vrátí false bez chyby.
Příklad vytvoří alpha/beta, volání zopakuje a vypíše 1 0 1: první vytvořilo cíl, druhé nic nezměnilo a koncový adresář existuje.
Nejde o transakci: když pozdější prvek selže, dřívější adresáře mohou zůstat. Existující komponenta, která není adresářem, nedostatečná práva nebo neplatná cesta hlásí chybu. Vyhazující přetížení používá filesystem_error; forma s error_code& ec hlásí přes ec, ale v C++23 není deklarována noexcept.
Příklady
#include <filesystem>
#include <iostream>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-create-directories";
const fs::path nested = root / "alpha" / "beta";
std::error_code ignored;
fs::remove_all(root, ignored);
const bool first = fs::create_directories(nested);
const bool second = fs::create_directories(nested);
std::cout << first << ' ' << second << ' ' << fs::is_directory(nested) << '\n';
fs::remove_all(root, ignored);
}
Výsledek
1 0 1
std::filesystem::create_directories → 1 0 1