Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::filesystem::create_directories : créer tout un chemin de répertoires

std::filesystem::create_directories crée dans l’ordre les répertoires manquants d’un chemin et indique si le répertoire final a été créé.

Version : 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) de <filesystem> effectue l’équivalent de create_directory pour chaque élément inexistant de p. Elle renvoie true seulement si le répertoire désigné par tout p a été créé ; s’il existait déjà, elle renvoie false sans erreur.

L’exemple crée alpha/beta, répète l’appel et affiche 1 0 1 : le premier a créé la cible, le second n’a rien changé et le répertoire final existe.

Ce n’est pas une transaction : si un élément tardif échoue, les répertoires antérieurs peuvent rester. Un composant existant non répertoire, un droit insuffisant ou un chemin invalide signale une erreur. La surcharge lançante utilise filesystem_error ; la forme error_code& ec rapporte via ec mais n’est pas déclarée noexcept en C++23.

Exemples

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

Résultat

1 0 1

std::filesystem::create_directories → 1 0 1

Sources