Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::filesystem::recursive_directory_iterator: rekurzívny priechod stromom

std::filesystem::recursive_directory_iterator je jednopriechodový vstupný iterátor cez adresár a jeho podadresáre.

Verzia: C++23

Syntax

class std::filesystem::recursive_directory_iterator {
public:
    using iterator_category = std::input_iterator_tag;
    recursive_directory_iterator() noexcept;
    explicit recursive_directory_iterator(const std::filesystem::path& p);
    int depth() const;
    bool recursion_pending() const;
    recursive_directory_iterator& operator++();
    void pop();
    void disable_recursion_pending();
};

std::filesystem::recursive_directory_iterator(p) z <filesystem> navštevuje objekty directory_entry pod p a automaticky zostupuje do podadresárov. depth() je 0 pre priame položky počiatočného adresára, 1 o úroveň nižšie atď.; poradie na každej úrovni nie je určené.

Príklad vytvorí súbor v hĺbke 0 a ďalší v podadresári, spočíta bežné súbory a najväčšiu hĺbku a vypíše 2 1. Pred inkrementáciou môže disable_recursion_pending() preskočiť potomkov aktuálneho adresára; pop() ukončí aktuálnu úroveň a pokračuje u rodiča.

Odkazy na adresáre sa predvolene nenasledujú; follow_directory_symlink ich zapne a cyklus potom môže znemožniť dosiahnutie konca. skip_permission_denied preskočí odmietnutie prístupu. Volanie depth, options, pop či riadenia rekurzie na koncovom iterátore je nedefinované správanie.

Príklady

#include <algorithm>
#include <filesystem>
#include <fstream>
#include <iostream>

int main() {
    namespace fs = std::filesystem;
    const fs::path root = fs::temp_directory_path() / "cktis-cpp-ref-recursive-iterator";
    std::error_code ignored;
    fs::remove_all(root, ignored);
    fs::create_directories(root / "sub");
    std::ofstream(root / "top.txt") << "top";
    std::ofstream(root / "sub" / "nested.txt") << "nested";

    int files = 0;
    int max_depth = 0;
    for (fs::recursive_directory_iterator it(root), end; it != end; ++it) {
        if (it->is_regular_file()) {
            ++files;
            max_depth = std::max(max_depth, it.depth());
        }
    }
    std::cout << files << ' ' << max_depth << '\n';

    fs::remove_all(root, ignored);
}

Výsledok

2 1

std::filesystem::recursive_directory_iterator → 2 1

Zdroje