std::experimental::filesystem:: recursive_directory_iterator

Integrado en ISO C++ La funcionalidad descrita en esta página fue integrada en el estándar principal de ISO C++ a partir de 3/2016; consulte std::filesystem::recursive_directory_iterator (desde C++17)

recursive_directory_iterator es un LegacyInputIterator que itera sobre los elementos directory_entry de un directorio, y, recursivamente, sobre las entradas de todos los subdirectorios. El orden de iteración no está especificado, excepto que cada entrada de directorio se visita solo una vez.

Por defecto, los enlaces simbólicos no se siguen, pero esto puede habilitarse especificando la opción de directorio follow_directory_symlink en el momento de la construcción.

Los nombres de ruta especiales dot y dot-dot se omiten.

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

Si un archivo o directorio se elimina o se agrega al árbol de directorios después de que se haya creado el iterador de directorio recursivo, no está especificado si el cambio se observaría a través del iterador.

Si la estructura del directorio contiene ciclos, el iterador final puede ser inalcanzable.

Tipos de miembros

Funciones miembro

Funciones no miembro

Además, operator== y operator!= se proporcionan, ya sea como miembros o como no miembros, según lo requerido por LegacyInputIterator .

Notas

Un recursive_directory_iterator normalmente mantiene un puntero con conteo de referencias (para satisfacer la semántica de copia superficial de LegacyInputIterator ) a un objeto de implementación, que contiene:

• un contenedor (como std::vector ) de directory_iterator s no recursivos que forma la pila de recursión.
• el contador de profundidad de recursión (accesible con depth() ).
• las opciones de directorio utilizadas en la construcción (accesibles con options() ).
• el indicador de recursión pendiente (accesible con recursion_pending() , puede combinarse con las opciones de directorio para ahorrar espacio).

Ejemplo

#include <experimental/filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
{
    fs::create_directories("sandbox/a/b");
    std::ofstream("sandbox/file1.txt");
    fs::create_symlink("a", "sandbox/syma");
    for (const fs::directory_entry& entry : fs::recursive_directory_iterator("sandbox"))
        std::cout << entry << '\n';
    fs::remove_all("sandbox");
}

"sandbox/a"
"sandbox/a/b"
"sandbox/file1.txt"
"sandbox/syma"

Véase también