readdir
是一个在 C 语言中用于读取目录内容的函数,其原型定义在 <dirent.h>
头文件中。readdir
函数的返回值是一个指向 struct dirent
结构体的指针,该结构体包含了关于目录中下一个条目的信息。
如果成功,readdir
返回一个指向 struct dirent
的指针,该结构体包含以下字段:
d_ino
: 目录项的 inode 号。d_off
: 目录项在目录文件中的偏移量。d_reclen
: 名称的长度。d_name
: 目录项的名称。如果到达目录的末尾,readdir
返回 NULL
。如果发生错误,也会返回 NULL
,并且可以通过调用 errno
来获取具体的错误代码。
下面是一个简单的例子,展示了如何使用 readdir
函数来遍历一个目录中的所有文件和子目录:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <errno.h>
int main(int argc, char *argv[]) {
DIR *dir;
struct dirent *entry;
if (argc != 2) {
fprintf(stderr, "Usage: %s <directory>\n", argv[0]);
return EXIT_FAILURE;
}
dir = opendir(argv[1]);
if (dir == NULL) {
perror("opendir");
return EXIT_FAILURE;
}
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
if (closedir(dir) == -1) {
perror("closedir");
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}
在这个例子中,程序接受一个命令行参数作为要遍历的目录路径。它打开目录,然后循环调用 readdir
来获取每个目录项,直到 readdir
返回 NULL
。每次循环中,它打印出目录项的名称。最后,它关闭目录并退出。如果在任何时候发生错误,程序会打印出错误信息并返回非零值。