CKTIS / C++
std::filesystem::directory_iterator: una pasada por un directorio
std::filesystem::directory_iterator es un iterador de entrada sobre las entradas inmediatas de un directorio y no desciende automáticamente a subdirectorios.
Versión: C++23
Sintaxis
class std::filesystem::directory_iterator {
public:
using iterator_category = std::input_iterator_tag;
directory_iterator() noexcept;
explicit directory_iterator(const std::filesystem::path& p);
const std::filesystem::directory_entry& operator*() const;
directory_iterator& operator++();
};std::filesystem::directory_iterator(p) de <filesystem> expone una secuencia de directory_entry para archivos directamente en p. Omite . y .., usa un orden no especificado y su constructor predeterminado crea el único valor final válido.
El ejemplo crea dos archivos que suman tres bytes, itera sin depender del orden e imprime 2 3. Es un iterador de entrada de una pasada: las copias no son dos cursores independientes y el final no puede desreferenciarse.
Si el directorio cambia durante la iteración, no se especifica si se observarán entradas añadidas o eliminadas. Un directory_entry puede guardar atributos en caché y su ruta puede ser un enlace colgante. Un error o avanzar tras el último elemento lleva el iterador al final; skip_permission_denied puede convertir una denegación al construir en rango vacío.
Ejemplos
#include <cstdint>
#include <filesystem>
#include <fstream>
#include <iostream>
int main() {
namespace fs = std::filesystem;
const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-directory-iterator";
std::error_code ignored;
fs::remove_all(root, ignored);
fs::create_directory(root);
std::ofstream(root / "a.txt") << "x";
std::ofstream(root / "b.txt") << "yz";
int regular_files = 0;
std::uintmax_t bytes = 0;
for (const fs::directory_entry& entry : fs::directory_iterator(root)) {
if (entry.is_regular_file()) {
++regular_files;
bytes += entry.file_size();
}
}
std::cout << regular_files << ' ' << bytes << '\n';
fs::remove_all(root, ignored);
}
Resultado
2 3
std::filesystem::directory_iterator → 2 3