readdir 函数通常用于读取目录中的文件和子目录。在C语言中,它是在 <dirent.h> 头文件中定义的。readdir 函数的原型如下:
struct dirent *readdir(DIR *dirp);
readdir 函数接受一个 DIR 类型的指针作为参数,该指针是通过 opendir 函数打开目录时返回的。readdir 函数返回一个指向 struct dirent 结构体的指针,该结构体包含了目录中的一个文件或子目录的信息。
struct dirent 结构体通常包含以下字段:
ino_t d_ino; - 文件或目录的 inode 号。char d_name[]; - 文件或目录的名称。这里是一个简单的例子,展示了如何使用 readdir 函数读取一个目录的内容:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
int main() {
DIR *dir;
struct dirent *entry;
dir = opendir("."); // 打开当前目录
if (dir == NULL) {
perror("opendir");
exit(EXIT_FAILURE);
}
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
closedir(dir);
return 0;
}
在这个例子中,我们首先使用 opendir 函数打开当前目录(.),然后使用 readdir 函数循环读取目录中的每个条目,直到 readdir 返回 NULL,表示已经到达目录的末尾。对于每个条目,我们打印出它的名称。最后,我们使用 closedir 函数关闭目录。
需要注意的是,struct dirent 结构体中的 d_name 字段是一个可变长度数组,它包含了文件或目录的名称以及终止的空字符。这意味着 d_name 的大小取决于实际的文件名长度,因此在使用时需要注意缓冲区的大小。