WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen