readdir与readdir_r的区别

首页

编程语言

热心网友

转载

2026-05-05

readdir与readdir_r：多线程环境下的目录读取该如何选择？

在C语言编程中，处理目录内容时，readdir和readdir_r是两个绕不开的函数。它们功能相似，但在多线程环境下的表现却截然不同。简单来说，一个需要你“小心伺候”，另一个则为你“保驾护航”。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

readdir与readdir_r的区别

上图清晰地概括了二者的核心差异，接下来我们深入细节，看看它们到底有何不同。

readdir：简单，但需警惕线程陷阱

线程安全性：这是readdir最关键的“阿喀琉斯之踵”。
- 它不是线程安全的。
- 这意味着，如果在多线程程序中不加保护地调用它，很容易引发竞态条件，导致数据错乱或程序崩溃。通常的解决方案是引入额外的同步机制，比如互斥锁，来确保同一时间只有一个线程在读取目录。
函数原型：
```
struct dirent *readdir(DIR *dirp);
```
返回值：
- 调用成功时，它会返回一个指向dirent结构的指针，这个结构里就装着目录项的名字等信息。
- 如果读到目录末尾或发生错误，则返回NULL。

使用示例：它的用法非常直观，是单线程环境下的首选。

DIR *dir = opendir("/path/to/directory");
if (dir == NULL) {
    perror("opendir");
    return 1;
}
struct dirent *entry;
while ((entry = readdir(dir)) != NULL) {
    printf("%s\n", entry->d_name);
}
closedir(dir);

readdir_r：为多线程而生的安全选择

线程安全性：readdir_r名字里那个“_r”（reentrant，可重入）已经说明了它的身份。
- 它是线程安全的。
- 其设计思路是，让调用者自己提供一个dirent结构缓冲区来存放结果，而不是依赖函数内部静态存储。这样一来，每个线程操作的都是自己的内存空间，自然就避免了冲突。

函数原型：

int readdir_r(DIR *dirp, struct dirent *entry, struct dirent **result);

返回值：
- 成功时返回0。
- 失败则返回非零值（错误码）。

使用示例：用法上稍显复杂，但换来了线程安全。

DIR *dir = opendir("/path/to/directory");
if (dir == NULL) {
    perror("opendir");
    return 1;
}
struct dirent entry;
struct dirent *result;
while (readdir_r(dir, &entry, &result) == 0 && result != NULL) {
    printf("%s\n", result->d_name);
}
closedir(dir);

总结与选择建议

线程安全性：这是根本区别。readdir_r是线程安全的，而readdir不是。
接口设计：readdir直接返回指针，简洁；readdir_r通过参数返回结果，并用整型返回值报告状态，更安全。
使用场景：这完全取决于你的程序运行环境。
- 如果你的程序是单线程的，或者你能百分百保证对目录流的访问是串行的（比如用锁精心保护），那么readdir的简洁性更具吸引力。
- 反之，只要身处多线程环境，尤其是需要并发读取目录时，readdir_r无疑是更稳妥、更专业的选择。毕竟，程序稳定性远比那一点点代码的复杂性重要。