Namespaces
Variants

std::filesystem:: begin (directory_iterator) , std::filesystem:: end (directory_iterator)

From cppreference.net
Определено в заголовке <filesystem>
directory_iterator begin ( directory_iterator iter ) noexcept ;
(1) (начиная с C++17)
directory_iterator end ( directory_iterator ) noexcept ;
(2) (начиная с C++17)
1) Возвращает iter без изменений.
2) Возвращает итератор, созданный конструктором по умолчанию directory_iterator , который служит конечным итератором. Аргумент игнорируется.

Эти нечленные функции позволяют использовать directory_iterator в циклах for на основе диапазонов и делают directory_iterator типом range (начиная с C++20) .

Содержание

Параметры

iter - a directory_iterator

Возвращаемое значение

1) iter без изменений.
2) Конечный итератор (по умолчанию созданный directory_iterator ).

Пример

#include <filesystem>
#include <fstream>
#include <iostream>
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");
}

Возможный вывод:

"sandbox/a"
"sandbox/file1.txt"
"sandbox/file2.txt"

Отчеты о дефектах

Следующие отчеты об изменениях в поведении, являющиеся дефектными, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
LWG 3480 C++17 end принимал аргумент по ссылке принимает аргумент по значению

Смотрите также

поддержка range-based for loop
(функция)