std::experimental::filesystem::begin(recursive_directory_iterator), std::experimental::filesystem::end(recursive_directory_iterator)

From cppreference.com
 
C++
 
Technical specifications
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals 2 TS)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Concepts (concepts TS)
Ranges (ranges TS)
Special mathematical functions (special math TR)
 
Filesystem library
Classes
Functions
File types
 
recursive_directory_iterator
 
recursive_directory_iterator begin( recursive_directory_iterator iter );
 (1) (filesystem TS)
recursive_directory_iterator end( const recursive_directory_iterator& );
 (2) (filesystem TS)
1) Returns iter unchanged
2) Returns a default-constructed recursive_directory_iterator, which serves as the end iterator. The argument is ignored.

These non-member functions enable the use of recursive_directory_iterators with range-based for loops.

Parameters

iter - a recursive_directory_iterator

Return value

1) iter unchanged
2) End iterator (default-constructed recursive_directory_iterator)

Exceptions

noexcept specification:  
noexcept
  

Example

Run this code
#include <fstream>
#include <iostream>
#include <experimental/filesystem>
namespace fs = std::experimental::filesystem;
 
int main()
{
    fs::create_directories("sandbox/a/b");
    std::ofstream("sandbox/file1.txt");
    fs::create_symlink("a", "sandbox/syma");
    for(auto& p: fs::recursive_directory_iterator("sandbox"))
        std::cout << p << '\n';
    fs::remove_all("sandbox");
}

Possible output: 

"sandbox/a"
"sandbox/a/b"
"sandbox/file1.txt"
"sandbox/syma"

See also

 range-based for loop support
(function)
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/experimental/fs/recursive_directory_iterator/begin&oldid=91925"