range-for迭代器类工作原理解析：std::filesystem::directory_iterator适配机制

好问题！你已经摸透了range-for循环的基本逻辑，但std::filesystem::directory_iterator的用法确实有点反直觉——它本身是个迭代器，不是容器，却能直接塞进range-for里正常遍历。让我给你拆解背后的门道：

先再明确range-for的完整展开逻辑 #

你说得没错，range-for本质是编译器帮你做了语法糖，它会把这段代码：

for (auto& elem : range) {
    // 循环体
}

展开成类似这样的简化版代码：

auto&& __range = range;
auto __begin = std::begin(__range);
auto __end = std::end(__range);
for (; __begin != __end; ++__begin) {
    auto& elem = *__begin;
    // 循环体
}

关键就在于std::begin和std::end这两个函数的行为——它们决定了range的起始和终止边界。

directory_iterator的特殊适配 #

std::filesystem::directory_iterator是C++17引入的输入迭代器，它的设计目标是按需遍历目录项（每次调用++时才去读取下一个目录条目，不会一次性加载所有内容到内存）。为了让它能直接用在range-for里，标准库给它做了特殊的std::begin和std::end重载：

• 当你传入一个directory_iterator对象给std::begin时，它直接返回这个对象本身（因为它就是遍历的起始迭代器）；
• 当你调用std::end时，它会返回一个默认构造的directory_iterator对象——这个默认构造的实例就是「尾后迭代器」，当遍历到目录末尾时，当前迭代器会和这个尾后迭代器相等，循环就终止了。

举个实际例子 #

比如你写了这样的代码：

#include <filesystem>
#include <iostream>
namespace fs = std::filesystem;

int main() {
    for (const auto& entry : fs::directory_iterator(".")) {
        std::cout << entry.path() << '\n';
    }
}

编译器会把它展开成：

auto&& __range = fs::directory_iterator(".");
auto __begin = std::begin(__range); // 返回__range本身，指向目录第一个条目
auto __end = std::end(__range);     // 返回默认构造的directory_iterator（尾后迭代器）

for (; __begin != __end; ++__begin) {
    const auto& entry = *__begin;
    std::cout << entry.path() << '\n';
}

每次++__begin时，迭代器会去读取下一个目录项；当遍历完所有条目后，__begin会变成和__end相等的状态，循环结束。

同类的设计思路 #

这种「迭代器本身作为range」的设计不是directory_iterator独有的，比如std::istream_iterator也是一样的逻辑：你可以直接写for (int num : std::istream_iterator<int>(std::cin))，用默认构造的istream_iterator作为输入结束的标记（当cin遇到EOF时，迭代器会等于尾后迭代器）。

总结一下：directory_iterator能支持range-for，核心是标准库为它适配了std::begin和std::end，让它自己成为一个合法的「范围」——起始是它本身，终止是默认构造的尾后迭代器，完美契合range-for的循环逻辑。

内容的提问来源于stack exchange，提问作者Poeta Kodu