readdir 是一个用于读取目录内容的函数,通常在 C 语言中使用。它定义在 <dirent.h> 头文件中。readdir 函数的原型如下:
struct dirent *readdir(DIR *dirp);
readdir 函数没有参数设置,它接受一个指向 DIR 结构的指针作为输入。这个结构通常是通过调用 opendir 函数打开目录时获得的。
readdir 函数返回一个指向 dirent 结构的指针,该结构包含了目录中的一个条目的信息。如果没有更多的目录条目,readdir 返回 NULL。
dirent 结构的定义如下:
struct dirent {
long d_ino; /* Inode number */
off_t d_off; /* Offset to the next dirent */
unsigned short d_reclen; /* Length of this dirent */
unsigned char d_type; /* Type of file */
char d_name[]; /* Filename */
};
其中,d_ino 是目录项的 inode 号,d_off 是下一个目录项的偏移量,d_reclen 是当前目录项的长度,d_type 是文件类型(例如 DT_REG 表示常规文件,DT_DIR 表示目录等),d_name 是目录项的名称。
在使用 readdir 函数时,通常需要遍历整个目录,直到 readdir 返回 NULL。以下是一个简单的示例:
#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <string.h>
int main(int argc, char *argv[]) {
DIR *dir;
struct dirent *entry;
if (argc != 2) {
fprintf(stderr, "Usage: %s <directory>\n", argv[0]);
exit(EXIT_FAILURE);
}
dir = opendir(argv[1]);
if (dir == NULL) {
perror("opendir");
exit(EXIT_FAILURE);
}
while ((entry = readdir(dir)) != NULL) {
printf("%s\n", entry->d_name);
}
closedir(dir);
return 0;
}
这个程序接受一个目录名作为命令行参数,并打印出该目录中的所有文件和子目录。