CKTIS / C++
std::filesystem::create_directories: vollständigen Verzeichnispfad anlegen
std::filesystem::create_directories erstellt fehlende Verzeichnisse eines Pfads der Reihe nach und meldet, ob das Zielverzeichnis neu entstand.
Version: C++23
Syntax
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) aus <filesystem> führt für jedes nicht vorhandene Element von p das Äquivalent zu create_directory aus. true wird nur geliefert, wenn das durch den vollständigen Pfad bezeichnete Verzeichnis angelegt wurde; bestand es schon, folgt false ohne Fehler.
Das Beispiel erstellt alpha/beta, wiederholt den Aufruf und gibt 1 0 1 aus: zuerst entstand das Ziel, danach änderte sich nichts, und das Endverzeichnis existiert.
Dies ist keine Transaktion: Scheitert ein späteres Element, können frühere Verzeichnisse bleiben. Eine vorhandene Nicht-Verzeichniskomponente, fehlende Rechte oder ein ungültiger Pfad melden einen Fehler. Der werfende Overload verwendet filesystem_error; die Form mit error_code& ec meldet über ec, ist in C++23 aber nicht als noexcept deklariert.
Beispiele
#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);
}
Ergebnis
1 0 1
std::filesystem::create_directories → 1 0 1