std::experimental::filesystem:: recursive_directory_iterator

已并入 ISO C++ 标准 本页描述的功能已于 2016 年 3 月并入主线的 ISO C++ 标准；请参阅 std::filesystem::recursive_directory_iterator (自 C++17 起)

recursive_directory_iterator 是一种 LegacyInputIterator ，用于遍历目录中的 directory_entry 元素，并递归地遍历所有子目录中的条目。迭代顺序未作规定，但每个目录条目仅会被访问一次。

默认情况下不会跟随符号链接，但可以通过在构造时指定目录选项 follow_directory_symlink 来启用此功能。

特殊路径名 dot 和 dot-dot 会被跳过。

若 recursive_directory_iterator 前进至顶层目录的最后一个目录条目之后，它将等同于默认构造的迭代器，即终止迭代器。两个终止迭代器始终相等，对终止迭代器进行解引用或递增操作均属于未定义行为。

如果在递归目录迭代器创建后，目录树中有文件或目录被删除或添加，则无法确定该变更是否会被迭代器检测到。

如果目录结构包含循环，则结束迭代器可能无法到达。

成员类型

成员函数

非成员函数

此外，根据 LegacyInputIterator 的要求，提供了 operator== 和 operator!= ，它们可以是成员函数或非成员函数。

备注

一个 recursive_directory_iterator 通常持有一个引用计数的 指针 （用于满足 LegacyInputIterator 的浅拷贝语义），该指针指向一个实现对象，该对象包含：

• 构成递归栈的非递归 directory_iterator s 容器（例如 std::vector ）。
• 递归深度计数器（可通过 depth() 访问）。
• 构造时使用的目录选项（可通过 options() 访问）。
• 待处理递归标志（可通过 recursion_pending() 访问，可与目录选项组合以节省空间）。

示例

#include <experimental/filesystem>
#include <fstream>
#include <iostream>
namespace fs = std::experimental::filesystem;
int main()
{
    fs::create_directories("sandbox/a/b");
    std::ofstream("sandbox/file1.txt");
    fs::create_symlink("a", "sandbox/syma");
    for (const fs::directory_entry& entry : fs::recursive_directory_iterator("sandbox"))
        std::cout << entry << '\n';
    fs::remove_all("sandbox");
}

"sandbox/a"
"sandbox/a/b"
"sandbox/file1.txt"
"sandbox/syma"

参见