std::filesystem::recursive_directory_iterator::disable_recursion_pending (3) - Linux Man Pages

std::filesystem::recursive_directory_iterator::disable_recursion_pending: std::filesystem::recursive_directory_iterator::disable_recursion_pending


std::filesystem::recursive_directory_iterator::disable_recursion_pending - std::filesystem::recursive_directory_iterator::disable_recursion_pending


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 directly 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.



Return value





// Run this code

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

  int main()
      fs::create_symlink("a", "sandbox/syma");
      for(auto i = fs::recursive_directory_iterator("sandbox");
               i != fs::recursive_directory_iterator();
             ++i ) {
          std::cout << std::string(i.depth(), ' ') << *i;
              std::cout << " -> " << fs::read_symlink(*i);
          std::cout << '\n';

          // do not descend into "b"
          if(i->path().filename() == "b")


  "sandbox/syma" -> "a"

See also

                  checks whether the recursion is disabled for the current directory
recursion_pending (public member function)
                  advances to the next entry
increment (public member function)