std::filesystem::begin(directory_iterator), std::filesystem::end(directory_iterator) - cppreference.com (original) (raw)

Defined in header
directory_iterator begin( directory_iterator iter ) noexcept; (1) (since C++17)
directory_iterator end( directory_iterator ) noexcept; (2) (since C++17)
  1. Returns iter unchanged.

  2. Returns a default-constructed

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).

[edit] Parameters

iter - a directory_iterator

[edit] Return value

  1. iter unchanged.

  2. End iterator (default-constructed directory_iterator).

[edit] Example

#include #include #include 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"

[edit] Defect reports

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

[edit] See also