std::filesystem:: begin (recursive_directory_iterator) , std::filesystem:: end (recursive_directory_iterator)
From cppreference.net
<
cpp
|
filesystem
|
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
s с циклами for на основе диапазонов
и делают
recursive_directory_iterator
типом
range
(начиная с C++20)
.
Содержание |
Параметры
| iter | - |
a
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 | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 3480 | C++17 |
end
принимал аргумент по ссылке
|
принимает аргумент по значению |
Смотрите также
|
поддержка range-based for loop
(функция) |