readdir 函数是用于读取目录内容的函数,在 C 语言中,它的原型在 <dirent.h> 头文件中定义。readdir 函数的返回值是一个指向 struct dirent 结构的指针,该结构包含了关于目录项的信息。如果成功,它返回一个指向目录项的指针;如果到达目录的末尾或者发生错误,则返回 NULL。
struct dirent 结构通常包含以下字段:
d_ino: 目录项的 inode 号。d_off: 目录项在目录文件中的偏移量。d_reclen: d_name 字段的长度。d_type: 目录项的类型(例如 DT_REG 表示常规文件,DT_DIR 表示目录等)。d_name: 目录项的名称。当 readdir 返回 NULL 时,可以通过检查 errno 全局变量来确定具体的错误原因。可能的错误包括:
EACCES: 权限不足,无法访问目录。ENOENT: 目录不存在。ENOTDIR: 指定的文件名不是一个目录。EIO: I/O 错误。ENOMEM: 内存不足。示例代码:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <errno.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);
}
if (errno != 0) {
perror("readdir");
}
closedir(dir);
return 0;
}
在这个示例中,程序打开当前目录(.),然后使用 readdir 函数读取目录中的每个条目,并打印它们的名称。如果在读取过程中发生错误,程序将打印错误信息。最后,使用 closedir 函数关闭目录。