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
函数关闭目录。