Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
std::experi...ion_pending(3)  C++ Standard Libary std::experi...ion_pending(3)

NAME
       std::experimental::filesystem::recursive_directory_iterator::dis-
       able_recursion_pending  -  std::experimental::filesystem::recursive_di-
       rectory_iterator::disable_recursion_pending

Synopsis
	  void disable_recursion_pending();  (filesystem TS)

	  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	recur-
       sion_pending(),
	  which	is false after this call. It is	reset back to true  after  in-
       crement,	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
       // Run this code

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

	int main()
	{
	    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");
	    for(auto i = fs::recursive_directory_iterator("sandbox");
		     i != fs::recursive_directory_iterator();
		   ++i ) {
		std::cout << std::string(i.depth(), ' ') << *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");
	}

Output:
	"sandbox/a"
	 "sandbox/a/b"
	"sandbox/syma" -> "a"

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

http://cppreference.com		  2022.07.31	  std::experi...ion_pending(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::experimental::filesystem::recursive_directory_iterator::disable_recursion_pending&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help