WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::filesystem::directory_iterator: einmaliger Durchlauf eines Verzeichnisses

std::filesystem::directory_iterator ist ein Eingabeiterator über unmittelbare Verzeichniseinträge und steigt nicht automatisch in Unterverzeichnisse ab.

Version: C++23

Syntax

class std::filesystem::directory_iterator {
public:
    using iterator_category = std::input_iterator_tag;
    directory_iterator() noexcept;
    explicit directory_iterator(const std::filesystem::path& p);
    const std::filesystem::directory_entry& operator*() const;
    directory_iterator& operator++();
};

std::filesystem::directory_iterator(p) aus <filesystem> liefert eine Folge von directory_entry-Objekten für Dateien direkt in p. . und .. werden ausgelassen, die Reihenfolge ist nicht spezifiziert, und der Standardkonstruktor erzeugt den einzigen gültigen Endwert.

Das Beispiel erstellt zwei Dateien mit zusammen drei Byte, iteriert reihenfolgeunabhängig und gibt 2 3 aus. Dies ist ein Eingabeiterator: Er ist nur für einen Durchlauf gedacht, Kopien sind keine unabhängigen Cursor, und der Endwert ist nicht dereferenzierbar.

Ändert sich das Verzeichnis während der Iteration, ist die Beobachtung hinzugefügter oder entfernter Einträge nicht spezifiziert. Ein directory_entry kann Attribute zwischenspeichern; sein Pfad kann ein hängender Symlink sein. Fehler oder Fortschritt hinter das letzte Element setzen den Iterator auf Ende; skip_permission_denied kann eine Zugriffsverweigerung beim Aufbau in einen leeren Bereich umwandeln.

Beispiele

#include <cstdint>
#include <filesystem>
#include <fstream>
#include <iostream>

int main() {
    namespace fs = std::filesystem;
    const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-directory-iterator";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directory(root);
    std::ofstream(root / "a.txt") << "x";
    std::ofstream(root / "b.txt") << "yz";

    int regular_files = 0;
    std::uintmax_t bytes = 0;
    for (const fs::directory_entry& entry : fs::directory_iterator(root)) {
        if (entry.is_regular_file()) {
            ++regular_files;
            bytes += entry.file_size();
        }
    }
    std::cout << regular_files << ' ' << bytes << '\n';

    fs::remove_all(root, ignored);
}

Ergebnis

2 3

std::filesystem::directory_iterator → 2 3

Quellen