Linux readdir与readdir_r的区别

readdir 和 readdir_r 都是用于读取目录内容的函数，但它们之间存在一些关键区别，主要体现在线程安全性和使用方式上。以下是对这两个函数的详细比较：

readdir

1. 定义：

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

2. 原型：

struct dirent *readdir(DIR *dirp);

3. 参数：

• dirp：指向已打开的目录流的指针。

4. 返回值：

• 成功时返回一个指向 dirent 结构体的指针，该结构体包含目录项的信息。
• 失败时返回 NULL。

5. 线程安全性：

• readdir 不是线程安全的。如果在多线程环境中使用同一个 DIR 流，可能会导致数据竞争和不一致的结果。

6. 使用示例：

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

1. 定义：

• readdir_r 是一个可重入版本的 readdir 函数，旨在提供线程安全性。

2. 原型：

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

3. 参数：

• dirp：指向已打开的目录流的指针。
• entry：一个指向 dirent 结构体的指针，用于存储读取到的目录项信息。
• result：一个指向 dirent 指针的指针，用于返回读取到的目录项的指针。

4. 返回值：

• 成功时返回 0。
• 失败时返回非零值。

5. 线程安全性：

• readdir_r 是线程安全的。它使用局部变量来存储中间结果，避免了多个线程同时访问共享数据的问题。

6. 使用示例：

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);

总结

• 线程安全性：readdir_r 是线程安全的，而 readdir 不是。
• 使用方式：readdir 直接返回一个指向 dirent 结构体的指针，而 readdir_r 需要传递额外的参数来存储和返回结果。
• 适用场景：在多线程环境中，推荐使用 readdir_r 以确保线程安全。

通过了解这些区别，可以根据具体的应用场景选择合适的函数来读取目录内容。