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 <string.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);
    }

    closedir(dir);
    return EXIT_SUCCESS;
}

在这个例子中，程序打开当前目录（用 "." 表示），然后循环调用 readdir 来读取每个目录项的名称，并打印出来。最后使用 closedir 关闭目录流。

注意事项

• 使用 readdir 时需要处理可能的错误情况，比如权限不足或目录不存在等。
• readdir 返回的名称不包含路径信息，如果需要完整路径，可能需要将目录名与父目录路径拼接起来。
• 在多线程环境中使用 readdir 时需要注意线程安全性。