std::experimental::filesystem::directory_iterator

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dateisystem-Bibliothek

Klassen
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator filesystem::file_status	filesystem::space_info filesystem::file_type filesystem::perms filesystem::copy_options filesystem::directory_options filesystem::file_time_type
Funktionen
filesystem::absolute filesystem::system_complete filesystem::canonical filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path filesystem::exists filesystem::equivalent	filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status filesystem::temp_directory_path
Dateitypen
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

directory_iterator

Memberfunktionen

directory_iterator::directory_iterator

directory_iterator::operator*directory_iterator::operator->

directory_iterator::operator=

directory_iterator::incrementdirectory_iterator::operator++

Nicht-Member-Funktionen

begin(directory_iterator)end(directory_iterator)

 

Definiert im Header <experimental/filesystem>
class directory_iterator;		(Dateisystem-TS)

directory_iterator ist ein LegacyInputIterator, der über die directory_entry-Elemente eines Verzeichnisses iteriert (besucht aber nicht die Unterverzeichnisse). Die Iterationsreihenfolge ist nicht spezifiziert, mit der Ausnahme, 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 fortgeschritten wird, wird er gleich dem standardkonstruierten 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 Verzeichnisiterators aus dem Verzeichnisbaum gelöscht oder hinzugefügt wird, ist es nicht spezifiziert, ob die Änderung über den Iterator beobachtet wird.

Membertypen

Mitgliedertyp	Definition
value_type	filesystem::directory_entry
difference_type	std::ptrdiff_t
Zeiger	const filesystem::directory_entry*
Referenz	const filesystem::directory_entry&
iterator_category	std::input_iterator_tag

Memberfunktionen

(Konstruktor)	konstruiert einen Verzeichnisiterator (public member function)
(Destruktor)	standardmäßiger Destruktor (public member function)
operator=	weist Inhalte zu (public member function)
operator*operator->	greift auf den Zeigereintrag zu (public member function)
incrementoperator++	bewegt sich zum nächsten Eintrag (public member function)

Nicht-Member-Funktionen

filesystem::begin(filesystem::directory_iterator)filesystem::end(filesystem::directory_iterator)

Unterstützung für range-basierte for-Schleifen (function)

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

Beispiel

Führen Sie diesen Code aus

#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");
}

Mögliche Ausgabe

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

Siehe auch

recursive_directory_iterator	ein Iterator für den Inhalt eines Verzeichnisses und seiner Unterverzeichnisse (Klasse)
directory_options	Optionen für das Iterieren über Verzeichnisinhalte (Aufzählung)
directory_entry	ein Verzeichniseintrag (Klasse)