std::experimental::filesystem::recursive_directory_iterator::operator++, increment

From cppreference.com
 
 
Experimental
Technical Specification
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
Experimental Non-TS
Pattern Matching
Linear Algebra
std::execution
Contracts
2D Graphics
 
 
 
recursive_directory_iterator& operator++();
(filesystem TS)
recursive_directory_iterator& increment( error_code& ec );
(filesystem TS)

Advances the iterator to the next entry.

If there are no more entries left in the currently iterated directory, the iteration is resumed over the parent directory. The process is repeated if the parent directory has no sibling entries that can to be iterated on. If the parent of the directory hierarchy that has been recursively iterated on is reached (there are no candidate entries at depth() == 0), *this is set to an end iterator.

Otherwise, if *this refers to a directory, it is iterated into if the following conditions are met:

  • disable_recursion_pending() has not been called before this increment, i.e. recursion_pending() == true.
  • The directory is not a symlink or following symlinks is enabled, i.e.
!is_symlink(this->symlink_status()) ||
    (options() & directory_options::follow_directory_symlink) != 0)
.

Parameters

ec - error code to store the error status to

Return value

*this

Exceptions

1) filesystem_error if an error occurs. The error code is set to an appropriate error code for the error that caused the failure.
2)
noexcept specification:  
noexcept