当前位置：首页 > 文章列表 > 文章 > linux > Linux程序员别错过：readdirvsreaddir_r深度解读

Linux程序员别错过：readdirvsreaddir_r深度解读

2025-06-12 23:45:25 0浏览收藏

作为Linux程序员，深入理解目录遍历函数至关重要。本文详解`readdir`和`readdir_r`这两个常用的目录读取函数，着重对比它们在使用方式和线程安全性上的关键差异。`readdir`函数简洁易用，但在多线程环境下存在数据竞争风险。`readdir_r`作为`readdir`的可重入版本，通过用户提供的缓冲区实现线程安全，更适用于多线程编程。本文通过代码示例，清晰展示了两个函数的用法，并总结了它们在线程安全、调用方式和适用场景上的区别，助你选择合适的目录读取方式，提升程序的稳定性和兼容性。掌握这些细节，让你的Linux编程技能更上一层楼！

Linux readdir与readdir_r的区别

readdir 和 readdir_r 都是用来遍历目录内容的函数，它们在使用方式和线程安全性方面有明显差异。下面将对这两个函数进行对比分析：

readdir

定义：

readdir 是 POSIX 标准中定义的一个目录读取函数，用于获取目录流中的下一个条目。

函数原型：

struct dirent *readdir(DIR *dirp);

参数说明：

返回值说明：

成功时返回一个指向 dirent 结构体的指针。
失败或到达目录末尾时返回 NULL。

线程安全特性：

readdir 不具备线程安全性。若多个线程同时操作同一个 DIR 流，可能会引发数据竞争问题。

使用示例代码：

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 是 readdir 的可重入版本，设计用于多线程环境，具有线程安全特性。

函数原型：

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

参数说明：

dirp：指向已打开目录流的指针。
entry：用于存放读取到的目录项的结构体指针。
result：指向 dirent 指针的指针，用于输出当前读取到的目录项。

返回值说明：

成功返回 0。
错误发生时返回非零值。

线程安全特性：

readdir_r 是线程安全的，它通过传入的缓冲区避免了共享数据的并发访问问题。

使用示例代码：

DIR *dir = opendir("/path/to/directory");
if (dir == NULL) {
    perror("opendir");
    return 1;
}

struct dirent entry;
struct dirent *result;
int ret;

while ((ret = readdir_r(dir, &entry, &result)) == 0 && result != NULL) {
    printf("%s\n", result->d_name);
}

closedir(dir);