在Linux中,readdir
函数用于读取目录中的条目。它的原型定义在dirent.h
头文件中,其函数原型如下:
int readdir(DIR *dirp, struct dirent *entry);
readdir
函数的参数有两个:
DIR *dirp
:这是一个指向DIR
结构体的指针,该结构体表示一个已打开的目录流。在使用opendir
函数打开一个目录后,会返回一个指向DIR
结构体的指针,该指针随后作为readdir
函数的第一个参数传入。
struct dirent *entry
:这是一个指向dirent
结构体的指针,用于存储读取到的目录项信息。dirent
结构体通常包含以下字段:
ino_t d_ino
:目录项的inode号。off_t d_off
:目录项在目录文件中的偏移量。unsigned short d_reclen
:目录项名的长度。char d_name[]
:目录项的名字。readdir
函数的工作方式是,每次调用都会从目录流dirp
中读取下一个目录项,并将其信息填充到entry
指向的dirent
结构体中。如果成功读取到一个目录项,readdir
返回一个非零值;如果已经到达目录流的末尾,返回NULL。
下面是一个简单的例子,展示如何使用readdir
函数:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
int main(int argc, char *argv[]) {
DIR *dir;
struct dirent *dp;
// 打开当前目录
dir = opendir(".");
if (dir == NULL) {
perror("opendir");
exit(EXIT_FAILURE);
}
// 读取目录中的每个条目
while ((dp = readdir(dir)) != NULL) {
printf("%s\n", dp->d_name);
}
// 关闭目录流
closedir(dir);
return 0;
}
在这个例子中,程序打开了当前目录(.
),然后循环调用readdir
来读取每个目录项,并打印出它们的名字。最后,使用closedir
函数关闭目录流。