Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::filesystem::create_directories: creare un intero percorso di directory

std::filesystem::create_directories crea in ordine le directory mancanti di un percorso e indica se ha creato la directory finale.

Versione: C++23

Sintassi

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) di <filesystem> esegue l’equivalente di create_directory per ogni elemento inesistente di p. Restituisce true solo se viene creata la directory risolta dall’intero p; se esisteva già restituisce false senza errore.

L’esempio crea alpha/beta, ripete la chiamata e stampa 1 0 1: la prima crea la destinazione, la seconda non cambia nulla e la directory finale esiste.

Non è una transazione: se un elemento successivo fallisce, le directory precedenti possono restare. Un componente esistente non directory, permessi insufficienti o un percorso non valido segnalano errore. L’overload che lancia usa filesystem_error; la forma con error_code& ec segnala tramite ec, ma in C++23 non è dichiarata noexcept.

Esempi

#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);
}

Risultato

1 0 1

std::filesystem::create_directories → 1 0 1

Fonti