std::experimental::filesystem:: directory_iterator

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

directory_iterator ist ein LegacyInputIterator , der über die directory_entry -Elemente eines Verzeichnisses iteriert (jedoch keine Unterverzeichnisse besucht). Die Iterationsreihenfolge ist nicht spezifiziert, außer dass jeder Verzeichniseintrag nur einmal besucht wird. Die speziellen Pfadnamen dot und dot-dot werden übersprungen.

Wenn der directory_iterator über den letzten Verzeichniseintrag 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 Verzeichnis-Iterators aus dem Verzeichnisbaum gelöscht oder hinzugefügt wird, ist es nicht spezifiziert, ob die Änderung durch den Iterator beobachtet wird.

Mitgliedertypen

Memberfunktionen

Nicht-Member-Funktionen

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

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"};
    std::ofstream{"sandbox/file2.txt"};
    for (const fs::directory_entry& entry : fs::directory_iterator{"sandbox"})
        std::cout << entry << '\n';
    fs::remove_all("sandbox");
}

"sandbox/a"
"sandbox/file1.txt"
"sandbox/file2.txt"

Siehe auch