命名空间
变体
操作

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

来自 cppreference.com
 
 
 
 
定义在头文件 <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 成为 范围 类型(自 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 通过引用获取参数 按值获取参数

[编辑] 另请参阅

基于范围的 for 循环支持
(函数) [编辑]