readdir 函数是用于读取目录内容的 POSIX 标准函数。它的原型通常在 <dirent.h> 头文件中定义,如下所示:
#include <dirent.h>
struct dirent *readdir(DIR *dirp);
readdir 函数只有一个参数:
DIR *dirp:这是一个指向 DIR 类型的指针,表示要读取的目录流。在使用 readdir 函数之前,通常需要使用 opendir 函数打开一个目录,并返回一个 DIR 指针。readdir 函数返回一个指向 struct dirent 结构的指针,该结构包含有关目录中的一个条目的信息。如果到达目录的末尾或发生错误,则返回 NULL。
struct dirent 结构通常包含以下字段:
long d_ino;:目录项的 inode 号。off_t d_off;:目录项在目录文件中的偏移量。unsigned short d_reclen;:目录项的长度。char d_name[];:目录项的名称。请注意,d_name 字段是一个可变长度数组,其大小足以容纳目录项的名称加上一个空字符终止符。
使用 readdir 函数时,通常会在一个循环中调用它,直到它返回 NULL,表示已经读取了目录中的所有条目。例如:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.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;
}
在这个例子中,程序打开当前目录(.),然后循环读取每个目录项,并打印其名称。最后,使用 closedir 函数关闭目录流。