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