readdir在Linux系统中的作用

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 关闭目录流，以释放相关资源。