std::experimental::filesystem::recursive_directory_iterator (3) - Linux Manuals
Defined in header <experimental/filesystem>
class recursive_directory_iterator; (filesystem TS)
recursive_directory_iterator is an LegacyInputIterator that iterates over the directory_entry elements of a directory, and, recursively, over the entries of all subdirectories. The iteration order is unspecified, except that each directory entry is visited only once.
By default, symlinks are not followed, but this can be enabled by specifying the directory option follow_directory_symlink at construction time.
The special pathnames dot and dot-dot are skipped.
If the recursive_directory_iterator is advanced past the last directory entry of the top-level directory, it becomes equal to the default-constructed iterator, also known as the end iterator. Two end iterators are always equal, dereferencing or incrementing the end iterator is undefined behavior.
If a file or a directory is deleted or added to the directory tree after the recursive directory iterator has been created, it is unspecified whether the change would be observed through the iterator.
If the directory structure contains cycles, the end iterator may be unreachable.
Member type Definition
pointer const filesystem::directory_entry*
reference const filesystem::directory_entry&
constructor (public member function)
destructor (public member function)
operator* (public member function)
options (public member function)
depth (public member function)
recursion_pending (public member function)
operator= (public member function)
increment (public member function)
pop (public member function)
disable_recursion_pending (public member function)
Additionally, operator== and operator!= are provided, either as members or as non-members, as required by LegacyInputIterator
A recursive_directory_iterator typically holds a reference-counted pointer (to satisfy shallow-copy semantics of LegacyInputIterator) to an implementation object, which holds:
* a container (such as std::vector) of non-recursive directory_iterators that forms the recursion stack
* the recursion depth counter (accessible with depth())
* the directory options used at construction (accessible with options())
* the pending recursion flag (accessible with recursion_pending(), may be combined with the directory options to save space)
// Run this code