readdir 是一个在 Linux 系统中用于读取目录内容的函数。它是 POSIX 标准的一部分,通常在 C 语言编程中使用。readdir 函数的作用是从一个打开的目录流中读取下一个目录项。
函数原型如下:
#include <dirent.h>
struct dirent *readdir(DIR *dirp);
参数:
dirp:一个指向 DIR 结构的指针,该结构表示一个已打开的目录流。通常通过 opendir 函数获得。返回值:
readdir 返回一个指向 dirent 结构的指针,该结构包含有关目录项的信息,如文件名、inode 号等。NULL。NULL 并设置全局变量 errno。dirent 结构定义如下:
struct dirent {
ino_t d_ino; /* Inode number */
off_t d_off; /* Not used by all filesystems */
unsigned short d_reclen; /* Length of this record */
unsigned char d_type; /* Type of file */
char d_name[]; /* Null-terminated filename */
};
d_type 字段表示文件类型,例如:
DT_REG:常规文件DT_DIR:目录DT_LNK:符号链接使用 readdir 函数可以遍历目录中的所有文件和子目录。以下是一个简单的示例:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <sys/types.h>
#include <sys/stat.h>
int main(int argc, char *argv[]) {
DIR *dir;
struct dirent *entry;
if (argc != 2) {
fprintf(stderr, "Usage: %s <directory>\n", argv[0]);
return EXIT_FAILURE;
}
dir = opendir(argv[1]);
if (dir == NULL) {
perror("opendir");
return EXIT_FAILURE;
}
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
closedir(dir);
return EXIT_SUCCESS;
}
这个程序接受一个目录作为命令行参数,并打印该目录中的所有文件和子目录。