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

DR	Применено к	Поведение, как опубликовано	Правильное поведение
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/w/cpp/filesystem/recursive_directory_iterator/begin