std::filesystem::directory_iterator

directory_iterator es un InputIterator que itera sobre los elementos directory_entry de un directorio pero no visita los subdirectorios. El orden de iteración no está especificado, excepto que cada entrada de directorio se visita solo una vez. Los nombres de ruta de acceso especiales punto y punto-punto se omiten.

Si el directory_iterator informa un error o avanza más allá de la última entrada del directorio, se vuelve igual al iterador construido por defecto, también conocido como el iterador final. Dos iteradores finales son siempre iguales, desreferenciar o incrementar el iterador final es un comportamiento no definido.

Si un archivo o un directorio se eliminan o se agregan al árbol de directorios después de que se haya creado el iterador del directorio, no se especifica si el cambio se observará a través del iterador.

[editar] Tipos miembro

[editar] Funciones miembro

[editar] Funciones no miembro

Además, se proporcionan operator== y operator!= (hasta C++20)se proporciona operator== (desde C++20), como se requiere por InputIterator.

No se especifica si operator!= se proporciona porque se puede sintetizar del operador operator==, y (desde C++20) si un operador de igualdad es una función miembro o no miembro.

[editar] Plantillas auxiliares

Estas especializaciones para directory_iterator lo hacen un borrowed_range y una vista (view).

[editar] Notas

Muchas API de bajo nivel del sistema operativo para el recorrido de directorios recuperan atributos de archivo junto con la siguiente entrada de directorio. Los constructores y las funciones miembro no const de std::filesystem::directory_iterator almacenan estos atributos, si los hay, en el objeto std::filesystem::directory_entry al que se apunta sin llamar a directory_entry::refresh, lo que permite examinar los atributos de las entradas de directorio a medida que se recorren, sin realizar llamadas adicionales al sistema.

[editar] Ejemplo

#include <fstream>
#include <iostream>
#include <filesystem>
 
int main()
{
    const std::filesystem::path entorno_aislado{"entorno_aislado"};
    std::filesystem::create_directories(entorno_aislado/"dir1"/"dir2");
    std::ofstream{entorno_aislado/"archivo1.txt"};
    std::ofstream{entorno_aislado/"archivo2.txt"};
 
    std::cout << "directory_iterator:\n";
    for(auto const& dir_entry: std::filesystem::directory_iterator{entorno_aislado})
        std::cout << dir_entry << '\n';
 
    std::cout << "recursive_directory_iterator:\n";
    for(auto const& dir_entry: std::filesystem::recursive_directory_iterator{entorno_aislado})
        std::cout << dir_entry << '\n';
 
    std::filesystem::remove_all(entorno_aislado);
}

directory_iterator:
"entorno_aislado/archivo2.txt"
"entorno_aislado/archivo1.txt"
"entorno_aislado/dir1"
recursive_directory_iterator:
"entorno_aislado/archivo2.txt"
"entorno_aislado/archivo1.txt"
"entorno_aislado/dir1"
"entorno_aislado/dir1/dir2"

[editar] Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

[editar] Véase también