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

Определён в заголовочном файле `<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_iterators в циклах for на основе диапазона и делают directory_iterator типом range(начиная с C++20).

Параметры

iter - 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++.

Отчёт об ошибке	Применяется к	Опубликованное поведение	Правильное поведение
LWG 3480	C++17	`end` принимал аргумент по ссылке	принимает аргумент по значению

См. также

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

(C++17)

поддержка циклов for на основе диапазона
(функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/filesystem/directory_iterator/begin