在Linux下,readdir()
函数用于读取目录中的条目。它的原型在<dirent.h>
头文件中定义,如下所示:
#include <dirent.h>
struct dirent *readdir(DIR *dirp);
readdir()
函数接受一个DIR
类型的指针作为参数,该指针指向一个已打开的目录流。函数的返回值是一个指向dirent
结构体的指针,该结构体包含有关目录条目的信息。如果到达目录流的末尾或发生错误,则返回NULL
。
dirent
结构体的定义如下:
struct dirent {
long d_ino; // inode号
off_t d_off; // 偏移量
unsigned short d_reclen; // 名称长度
char d_name[]; // 目录条目名称
};
d_ino
:目录条目的inode号。
d_off
:目录条目在目录文件中的偏移量。
d_reclen
:目录条目名称的长度(不包括空字符)。
d_name
:目录条目的名称。这是一个可变长度的字段,实际长度由d_reclen
指定。
使用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("Name: %s\n", entry->d_name);
}
closedir(dir);
return 0;
}
这个示例程序打开当前目录,然后使用readdir()
函数遍历目录中的所有条目,并打印它们的名称。最后,关闭目录流。