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