Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::filesystem::directory_iterator: pojedyncze przejście po katalogu

std::filesystem::directory_iterator jest iteratorem wejściowym po bezpośrednich wpisach katalogu, bez automatycznego schodzenia do podkatalogów.

Wersja: C++23

Składnia

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) z <filesystem> daje sekwencję directory_entry dla plików bezpośrednio w p. Pomija wpisy . i .., ma nieokreśloną kolejność, a konstruktor domyślny tworzy jedyną poprawną wartość końca.

Przykład tworzy dwa pliki o łącznym rozmiarze trzech bajtów, iteruje bez zależności od kolejności i drukuje 2 3. To iterator wejściowy: jest jednoprzejściowy, jego kopie nie dają semantyki dwóch niezależnych kursorów, a końca nie wolno dereferencjonować.

Po zmianie katalogu w trakcie iteracji nie wiadomo, czy dodany lub usunięty wpis zostanie zaobserwowany. directory_entry może zawierać zbuforowane atrybuty, a ścieżka może być wiszącym dowiązaniem. Błąd albo przejście za ostatni element ustawia iterator na koniec; skip_permission_denied może zamienić odmowę dostępu przy konstrukcji w pusty zakres.

Przykłady

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

Wynik

2 3

std::filesystem::directory_iterator → 2 3

Źródła