readdir 函数是一种用于获取目录内容的工具函数，在遵循 POSIX 标准的操作系统（例如 Linux 和 macOS）中广泛使用。此函数的定义可以在 头文件中找到。readdir 函数的参数如下所示：

struct dirent *readdir(DIR *dirp);

• DIR *dirp：这代表一个指向 DIR 类型的指针，用于标识需要读取的目录流。在使用 readdir 之前，需要通过调用 opendir 函数开启目录，并得到一个有效的 DIR 指针。

readdir 函数本身并不直接返回结果状态，而是通过返回值来传递信息。若执行成功，它会返回一个指向 struct dirent 结构体的指针，这个结构体包含了关于目录中下一个条目的一些细节信息。当到达目录结尾或者出现错误时，函数将返回 NULL。

struct dirent 结构体一般包括以下成员：

• long d_ino：这是文件的 inode 编号。
• off_t d_off：偏移量，用于下一次读取操作。
• unsigned short d_reclen：d_name 字段的实际长度。
• char d_name[]：一个以 null 结尾的字符串形式的文件名称。

需要注意的是，在多线程程序中使用 readdir 函数时，可能会遇到线程安全问题，因为多个线程可能同时对同一个目录流进行操作。此时，应当采取适当的同步措施来防止潜在的竞争条件。