std::experimental::filesystem:: recursive_directory_iterator

In ISO C++ integriert Die auf dieser Seite beschriebene Funktionalität wurde ab 3/2016 in den Hauptstandard von ISO C++ übernommen; siehe std::filesystem::recursive_directory_iterator (seit C++17)

recursive_directory_iterator ist ein LegacyInputIterator , der über die directory_entry -Elemente eines Verzeichnisses und rekursiv über die Einträge aller Unterverzeichnisse iteriert. Die Iterationsreihenfolge ist nicht spezifiziert, außer dass jeder Verzeichniseintrag nur einmal besucht wird.

Standardmäßig werden symbolischen Verknüpfungen nicht gefolgt, dies kann jedoch durch Angabe der Verzeichnisoption follow_directory_symlink zur Konstruktionszeit aktiviert werden.

Die speziellen Pfadnamen dot und dot-dot werden übersprungen.

Wenn der recursive_directory_iterator über den letzten Verzeichniseintrag des obersten Verzeichnisses hinaus bewegt wird, wird er gleich dem standardmäßig konstruierten Iterator, auch bekannt als End-Iterator. Zwei End-Iteratoren sind immer gleich, das Dereferenzieren oder Inkrementieren des End-Iterators ist undefiniertes Verhalten.

Wenn eine Datei oder ein Verzeichnis nach der Erstellung des rekursiven Verzeichnis-Iterators aus dem Verzeichnisbaum gelöscht oder hinzugefügt wird, ist es nicht spezifiziert, ob die Änderung durch den Iterator beobachtet werden würde.

Wenn die Verzeichnisstruktur Zyklen enthält, könnte der End-Iterator unerreichbar sein.

Mitgliedertypen

Memberfunktionen

Nicht-Member-Funktionen

Zusätzlich werden operator== und operator!= bereitgestellt, entweder als Member oder als Non-Member, wie von LegacyInputIterator gefordert.

Hinweise

Ein recursive_directory_iterator enthält typischerweise einen referenzgezählten Zeiger (um die Flachkopie-Semantik von LegacyInputIterator zu erfüllen) auf ein Implementierungsobjekt, das Folgendes enthält:

• ein Container (wie std::vector ) von nicht-rekursiven directory_iterator s , der den Rekursionsstapel bildet.
• der Rekursionstiefenzähler (zugänglich mit depth() ).
• die bei der Konstruktion verwendeten Verzeichnisoptionen (zugänglich mit options() ).
• das ausstehende Rekursionsflag (zugänglich mit recursion_pending() , kann mit den Verzeichnisoptionen kombiniert werden, um Speicherplatz zu sparen).

Beispiel

#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"

Siehe auch