readdir
函数是 Linux 中用于读取目录内容的函数,其原型定义在 <dirent.h>
头文件中。readdir
函数的原型如下:
struct dirent *readdir(DIR *dirp);
readdir
函数只有一个参数:
DIR *dirp
:这是一个指向 DIR
类型的指针,表示要读取的目录流。在使用 readdir
函数之前,通常需要使用 opendir
函数打开目录,并返回一个 DIR
类型的指针。例如:DIR *dir = opendir("/path/to/directory");
if (dir == NULL) {
// 处理错误
}
readdir
函数的作用是从目录流 dirp
中读取下一个目录项,并返回一个指向 struct dirent
结构的指针。struct dirent
结构包含了目录项的信息,如文件名、文件类型等。
当 readdir
函数读取到目录流的末尾时,它将返回 NULL
。
以下是一个使用 readdir
函数的简单示例:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
int main() {
DIR *dir = opendir("/path/to/directory");
if (dir == NULL) {
perror("opendir");
return EXIT_FAILURE;
}
struct dirent *entry;
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
closedir(dir);
return EXIT_SUCCESS;
}
在这个示例中,我们首先使用 opendir
函数打开目录,然后使用 readdir
函数读取目录中的每个目录项,并打印文件名。最后,我们使用 closedir
函数关闭目录流。