Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje