芯耀
262
1.头文件
#include <dirent.h>
2.函数原型
struct dirent *readdir(DIR *dirp);
3.参数
dirp：指向由 opendir() 返回的 DIR 结构体的指针，用于表示打开的目录流。
4.返回值
成功：返回指向 dirent 结构体的指针，该结构体包含目录项的信息。
结束或错误：当目录项读取完毕或发生错误时，返回 NULL。通常，readdir 返回 NULL 表示目录读取结束，或者遇到错误时可以通过 errno 获取更多信息。
注：
流是抽象的一个数据通道，目录流（DIR 类型的对象）是一个表示打开目录的抽象数据通道。通过这个流，我们可以按顺序读取目录中的每一个条目。
下面就来介绍一下struct dirent结构体：
struct dirent {
ino_t d_ino; /* Inode 编号 */
off_t d_off; /* Not an offset; see below */
unsigned short d_reclen; /* Length of this record */
unsigned char d_type; /* Type of file; not supported by all filesystem types */
char d_name[256]; /* 文件名 */
};
在这个结构体中，需要重点关注的是d_ino和d_name这两个字段即可，其余的字段一般是用不上，所以不用重点关注。
每调用一次readdir函数，就会从drip所指向的目录有中读取下一条目录项，并返回一个struct dirent结构体指针，指向经静态分配而得的 struct dirent 类型结构，每次调用 readdir()都会覆盖该结构。一旦遇到目录结尾或是出错，readdir()将返回 NULL，针对后一种情况，还会设置 errno 以示具体错误。
这时就有问题了，什么时候是指向了目录的末尾，什么时候是出错了呢？以下给出代码参考进行判断：
| struct dirent *entry;
// 读取目录项 while ((entry = readdir(dir)) != NULL) { // 打印目录项名称 printf("Name: %sn", entry->d_name); } // 检查是否有读取错误 if (errno != 0) { perror("readdir"); closedir(dir); return EXIT_FAILURE; } |
需要注意的是，在使用readdir()函数时，返回的内容并非是使用文件名进行排序的，而是取决于文件系统向该目录添加文件时所遵循的顺序，和在文件被删除以后对目录列表中空隙的填补方式进行排序。
