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_iterator
s 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