# std::filesystem::recursive_directory_iterator::disable_recursion_pending

> C++ Atlas: `cppatlas.com/w/cpp/filesystem/recursive_directory_iterator/disable_recursion_pending` | Source: https://en.cppreference.com/w/cpp/filesystem/recursive_directory_iterator/disable_recursion_pending | Domain: Filesystem | Standards: C++17

Disables recursion to the currently referred subdirectory, if any.

## Official Specification Summary (cppreference)

```cpp
void disable_recursion_pending(); // (since C++17)
```

Disables recursion to the currently referred subdirectory, if any.

The call modifies the pending recursion flag on the iterator in such a way that the next time `increment` is called, the iterator will advance within the current directory even if it is currently referring to a subdirectory that hasn't been visited.

The status of the pending recursion flag can be queried with `recursion_pending()`, which is `false` after this call. It is reset back to `true` after `increment`, and its initial value is also `true`.

The behavior is undefined if `*this` is the end iterator.

### Parameters

(none)

### Return value

(none)

### Exceptions

May throw implementation-defined exceptions.

### Example

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

Possible output:

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

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

### See also

- [`recursion_pending`](https://en.cppreference.com/w/cpp/filesystem/recursive_directory_iterator/recursion_pending): checks whether the recursion is disabled for the current directory (public member function)
- [`increment`](https://en.cppreference.com/w/cpp/filesystem/recursive_directory_iterator/increment), [`operator++`](https://en.cppreference.com/w/cpp/filesystem/recursive_directory_iterator/increment): advances to the next entry (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/filesystem/recursive_directory_iterator/disable_recursion_pending (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.