cpp/filesystem/recursive directory iterator/recursion pending

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

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

Parameters
(none)

Return value
if the next increment will iterate into the currently referred directory, otherwise.

Exceptions
Throws nothing.