readdir与readdir_r的区别

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

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

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

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

1. 线程安全性：这是readdir最关键的“阿喀琉斯之踵”。

   • 它不是线程安全的。
   • 这意味着，如果在多线程程序中不加保护地调用它，很容易引发竞态条件，导致数据错乱或程序崩溃。通常的解决方案是引入额外的同步机制，比如互斥锁，来确保同一时间只有一个线程在读取目录。

2. 函数原型：

   struct dirent *readdir(DIR *dirp);

3. 返回值：

   • 调用成功时，它会返回一个指向dirent结构的指针，这个结构里就装着目录项的名字等信息。
   • 如果读到目录末尾或发生错误，则返回NULL。

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

   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名字里那个“_r”（reentrant，可重入）已经说明了它的身份。

   • 它是线程安全的。
   • 其设计思路是，让调用者自己提供一个dirent结构缓冲区来存放结果，而不是依赖函数内部静态存储。这样一来，每个线程操作的都是自己的内存空间，自然就避免了冲突。

2. 函数原型：

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

3. 返回值：

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

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

   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无疑是更稳妥、更专业的选择。毕竟，程序稳定性远比那一点点代码的复杂性重要。

所以，下次在代码里需要读取目录时，不妨先问自己一句：我的程序会跑在多个线程里吗？想清楚这个问题，选择也就一目了然了。