std::filesystem::recursive_directory_iterator::disable_recursion_pending

void disable_recursion_pending();

(начиная с C++17)

Отключает рекурсию для текущего каталога, на который ссылается итератор, если таковой имеется.

Вызов изменяет флаг ожидающей рекурсии итератора таким образом, что при следующем вызове increment итератор перейдёт к следующему элементу в текущем каталоге, даже если в данный момент он указывает на ещё не посещённый подкаталог.

Состояние флага ожидающей рекурсии можно проверить с помощью recursion_pending(); после этого вызова он равен false. После вызова increment он снова устанавливается в true, и его начальное значение также равно true.

Поведение не определено, если *this является конечным итератором.

Параметры

(нет)

Возвращаемое значение

(нет)

Исключения

Могут быть выброшены исключения, определяемые реализацией.

Пример

#include <cstdlib>
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
namespace fs = std::filesystem;

int main()
{
    fs::current_path(fs::temp_directory_path());
    fs::create_directories("sandbox/a/b/c");
    fs::create_directories("sandbox/a/b/d/e");
    std::ofstream("sandbox/a/b/file1.txt");
    fs::create_symlink("a", "sandbox/syma");
    std::system("tree sandbox");
    for (auto i = fs::recursive_directory_iterator("sandbox");
         i != fs::recursive_directory_iterator();
         ++i)
    {
        std::cout << std::string(i.depth() * 2, ' ') << *i;
        if (fs::is_symlink(i->symlink_status()))
            std::cout << " -> " << fs::read_symlink(*i);
        std::cout << '\n';

        // do not descend into "b"
        if (i->path().filename() == "b")
            i.disable_recursion_pending();
    }
    fs::remove_all("sandbox");
}

Возможный вывод:

sandbox
├── a
│   └── b
│       ├── c
│       ├── d
│       │   └── e
│       └── file1.txt
└── syma -> a

"sandbox/a"
  "sandbox/a/b"
"sandbox/syma" -> "a"

См. также

recursion_pending	проверяет, отключена ли рекурсия для текущего каталога (открытая функция-член)
incrementoperator++	переходит к следующему элементу (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/filesystem/recursive_directory_iterator/disable_recursion_pending