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

Определён в заголовке `<filesystem>`
recursive_directory_iterator begin( recursive_directory_iterator iter ) noexcept;	(1)	(начиная с C++17)
recursive_directory_iterator end( recursive_directory_iterator ) noexcept;	(2)	(начиная с C++17)

1) Возвращает iter без изменений.

2) Возвращает recursive_directory_iterator, созданный по умолчанию и служащий конечным итератором. Аргумент игнорируется.

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

Параметры

iter - recursive_directory_iterator

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

1) iter без изменений.

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

Пример

#include <cstdlib>
#include <filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::filesystem;

int main()
{
    fs::current_path(fs::temp_directory_path());
    fs::create_directories("sandbox/a/b");
    std::ofstream("sandbox/file1.txt");
    fs::create_symlink("a", "sandbox/syma");

    std::cout << "Print dir structure using OS specific command 'tree':\n";
    std::system("tree --noreport sandbox");

    std::cout << "\nPrint dir structure using directory iterator:\n";
    for (auto& p : fs::recursive_directory_iterator("sandbox"))
        std::cout << p << '\n';

    fs::remove_all("sandbox");
}

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

Print dir structure using OS specific command 'tree':
sandbox
├── a
│   └── b
├── file1.txt
└── syma -> a

Print dir structure using directory iterator:
"sandbox/syma"
"sandbox/file1.txt"
"sandbox/a"
"sandbox/a/b"

Отчёты об ошибках

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

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

См. также

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

(C++17)

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

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