readdir 是一个在 Linux 系统中用于读取目录内容的函数。它是 POSIX 标准的一部分,通常在 C 语言编程中使用。通过 readdir 函数,程序可以获取指定目录中的文件和子目录的列表。
#include <dirent.h> struct dirent *readdir(DIR *dirp); DIR *dirp: 这是一个指向 DIR 类型的指针,通常通过 opendir 函数打开一个目录得到。readdir 返回一个指向 struct dirent 结构的指针,该结构包含有关目录中下一个条目的信息。NULL。NULL,可以通过 errno 获取具体的错误信息。struct dirent 结构struct dirent 结构通常包含以下字段:
ino_t d_ino: 文件的 inode 号。off_t d_off: 条目的偏移量。unsigned short d_reclen: 名称的长度。char d_type: 文件类型(例如 DT_REG 表示常规文件,DT_DIR 表示目录)。char d_name[]: 文件或目录的名称。以下是一个简单的使用 readdir 的示例代码:
#include <stdio.h> #include <stdlib.h> #include <dirent.h> #include <errno.h> int main() { DIR *dir; struct dirent *entry; dir = opendir("."); if (dir == NULL) { perror("opendir"); return EXIT_FAILURE; } while ((entry = readdir(dir)) != NULL) { printf("%s\n", entry->d_name); } if (closedir(dir) == -1) { perror("closedir"); return EXIT_FAILURE; } return EXIT_SUCCESS; } 在这个示例中,程序打开当前目录(.),然后使用 readdir 读取目录中的每个条目,并打印出它们的名称。最后,使用 closedir 关闭目录。
readdir 时需要处理可能的错误情况。readdir 返回的指针指向的内容可能在下一次调用 readdir 时被覆盖,因此如果需要保留这些信息,应该及时复制。closedir 关闭目录流,以释放相关资源。