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;
}
这个程序接受一个目录作为命令行参数,并打印该目录中的所有文件和子目录。