在Linux中,readdir()
函数用于读取目录中的条目。它的原型在<dirent.h>
头文件中定义,如下所示:
#include <dirent.h>
DIR *opendir(const char *name);
struct dirent *readdir(DIR *dirp);
int closedir(DIR *dirp);
readdir()
函数返回一个指向dirent
结构体的指针,该结构体包含了目录条目的信息。如果到达目录的末尾或者发生错误,则返回NULL。
dirent
结构体通常包含以下字段:
d_ino
: 目录条目的inode号。d_off
: 条目在目录文件中的偏移量。d_reclen
: dirent
结构的长度。d_name
: 条目的名称,以空字符结尾的字符串。下面是一个简单的例子,展示了如何使用readdir()
函数来遍历一个目录中的所有条目:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
int main() {
DIR *dir;
struct dirent *entry;
// 打开目录
dir = opendir(".");
if (dir == NULL) {
perror("opendir");
exit(EXIT_FAILURE);
}
// 读取目录中的条目
while ((entry = readdir(dir)) != NULL) {
printf("Entry name: %s\n", entry->d_name);
}
// 关闭目录
if (closedir(dir) == -1) {
perror("closedir");
exit(EXIT_FAILURE);
}
return 0;
}
在这个例子中,我们首先使用opendir()
函数打开当前目录(.
)。然后,我们使用一个循环来调用readdir()
函数,直到它返回NULL,这意味着我们已经到达了目录的末尾。对于每个条目,我们打印出它的名称。最后,我们使用closedir()
函数关闭目录。
需要注意的是,readdir()
返回的d_name
字段是一个以空字符结尾的字符串,它指向目录中的一个条目名称。这个名称可能是相对路径,也可能是绝对路径的一部分,具体取决于目录条目的类型。如果需要获取完整的路径,可以将目录名和条目名拼接起来。
此外,readdir()
函数返回的dirent
结构体是由内核分配的,因此不需要(也不能)手动释放它。但是,如果在调用readdir()
期间目录被删除或者发生了其他错误,返回的指针可能会变得无效。因此,在处理完目录条目后,应该尽快关闭目录。