# std::filesystem::recursive_directory_iterator::recursion_pending

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

Returns true if the next increment will cause the directory currently referred to by *this to be iterated into.

## Official Specification Summary (cppreference)

```cpp
bool recursion_pending() const; // (since C++17)
```

Returns `true` if the next increment will cause the directory currently referred to by `*this` to be iterated into.

This function returns `true` immediately after construction or an increment. Recursion can be disabled via `disable_recursion_pending()`.

### Parameters

(none)

### Return value

`true` if the next increment will iterate into the currently referred directory, `false` otherwise.

### Exceptions

Throws nothing.

### Example

> Note: This section is incomplete Reason: no example

---
Attribution: content from https://en.cppreference.com/w/cpp/filesystem/recursive_directory_iterator/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.