CKTIS / C++
std::filesystem::create_directories: criar todo um caminho de diretórios
std::filesystem::create_directories cria por ordem os diretórios em falta num caminho e indica se criou o diretório final.
Versão: C++23
Sintaxe
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> executa o equivalente a create_directory para cada elemento inexistente de p. Devolve true apenas se criou o diretório resolvido por todo p; se este já existia, devolve false sem erro.
O exemplo cria alpha/beta, repete a chamada e imprime 1 0 1: a primeira criou o destino, a segunda nada alterou e o diretório final existe.
Não é uma transação: se um elemento posterior falhar, diretórios anteriores podem ficar. Um componente existente que não seja diretório, permissões insuficientes ou caminho inválido comunicam erro. A sobrecarga que lança usa filesystem_error; a forma com error_code& ec comunica por ec, mas em C++23 não está declarada noexcept.
Exemplos
#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);
}
Resultado
1 0 1
std::filesystem::create_directories → 1 0 1