在Linux中,readdir()函数用于读取目录中的条目。它的原型在<dirent.h>头文件中定义,如下所示:
struct dirent *readdir(DIR *dirp);
readdir()函数的返回值是一个指向struct dirent结构体的指针,该结构体包含了关于目录条目的信息。如果读取成功,返回的指针指向一个有效的struct dirent结构体;如果已经到达目录的末尾或者发生错误,返回NULL。
struct dirent结构体通常包含以下成员:
d_ino: 目录条目的inode号。d_off: 条目在目录文件中的偏移量。d_reclen: 结构体的长度。d_name: 条目的名称,最长为255个字符。如果在调用readdir()时发生错误,可以通过检查errno全局变量来确定具体的错误类型。常见的错误包括:
EACCES: 权限不足,无法访问目录。ENOENT: 目录不存在。EMFILE: 打开的文件描述符太多,无法继续打开新的文件。ENOTDIR: 文件描述符指向的不是目录。EFAULT: dirp指向的内存地址不可访问。EINVAL: dirp无效。使用readdir()函数时,通常会在一个循环中调用它,直到返回NULL为止,这样可以遍历目录中的所有条目。下面是一个简单的例子:
#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]);
exit(EXIT_FAILURE);
}
dir = opendir(argv[1]);
if (dir == NULL) {
perror("opendir");
exit(EXIT_FAILURE);
}
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
if (closedir(dir) == -1) {
perror("closedir");
exit(EXIT_FAILURE);
}
return 0;
}
在这个例子中,程序接受一个命令行参数作为目录名,然后打开该目录并列出其中的所有条目。如果opendir()或readdir()失败,程序会打印错误信息并退出。最后,使用closedir()关闭目录。