cpp/filesystem/recursive directory iterator/disable recursion pending

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 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, which is after this call. It is reset back to after, and its initial value is also.

The behavior is undefined if is the end iterator.

Parameters
(none)

Return value
(none)