readdir函数返回的dirent结构体详解

readdir 函数是用于读取目录内容的函数，在 POSIX 标准中定义，通常在 <dirent.h> 头文件中声明。该函数用于遍历一个打开的目录流，并返回目录中的下一个条目。

readdir 函数的原型如下：

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

参数

• DIR *dirp: 这是一个指向 DIR 类型的指针，表示已经通过 opendir 函数打开的目录流。

返回值

• 成功时，readdir 返回一个指向 dirent 结构体的指针，该结构体包含有关目录条目的信息。
• 如果已经到达目录流的末尾，返回 NULL。
• 如果发生错误，也返回 NULL，可以通过 errno 获取具体的错误信息。

dirent 结构体

dirent 结构体用于存储目录条目的信息，其定义通常如下（具体实现可能略有不同）：

struct dirent {
    long d_ino;             // inode 号
    off_t d_off;            // 偏移量（在新版本中）
    unsigned short d_reclen; // 名称的长度
    char d_name[];          // 目录条目的名称（以 null 结尾的字符串）
};

字段详解

• d_ino: 这是目录条目对应的 inode 号。inode 是文件系统中用于存储文件信息的数据结构。

• d_off: 这是目录条目在目录文件中的偏移量。这个字段是在 Linux 2.6.15 及以后的版本中引入的，用于支持非顺序读取。

• d_reclen: 这是 d_name 字段的长度，不包括终止的空字符。这个字段也是在新版本中引入的。

• d_name: 这是一个以 null 结尾的字符串，表示目录条目的名称。这是一个可变长度的数组，实际的大小由 d_reclen 指定。

使用示例

以下是一个简单的示例，展示如何使用 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");
        exit(EXIT_FAILURE);
    }

    while ((entry = readdir(dir)) != NULL) {
        printf("%s\n", entry->d_name);
    }

    if (closedir(dir) == -1) {
        perror("closedir");
        exit(EXIT_FAILURE);
    }

    return 0;
}

在这个示例中，程序打开当前目录并逐个打印目录中的文件和子目录名。注意错误处理，以确保在打开或关闭目录时出现问题时能够正确处理。