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_iterator с циклами range-based 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++.

DR	Применено к	Поведение, как опубликовано	Корректное поведение
LWG 3480	C++17	`end` принимала аргумент по ссылке	принимает аргумент по значению

См. также

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

Поддержка циклов range-based for
(функция)

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