Defined in header <filesystem> | ||
|---|---|---|
directory_iterator begin( directory_iterator iter ) noexcept; | (1) | (since C++17) |
directory_iterator end( directory_iterator ) noexcept; | (2) | (since C++17) |
iter unchanged.directory_iterator, which serves as the end iterator. The argument is ignored.These non-member functions enable the use of directory_iterators with range-based for loops and make directory_iterator a range type (since C++20).
| iter | - | a directory_iterator |
iter unchanged.directory_iterator).#include <fstream>
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;
int main()
{
fs::create_directories("sandbox/a/b");
std::ofstream("sandbox/file1.txt");
std::ofstream("sandbox/file2.txt");
for(auto& p: fs::directory_iterator("sandbox"))
std::cout << p << '\n';
fs::remove_all("sandbox");
}Possible output:
"sandbox/a" "sandbox/file1.txt" "sandbox/file2.txt"
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3480 | C++17 | end took the argument by reference | takes the argument by value |
| range-based for loop support (function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/directory_iterator/begin