Linux中readdir函数详解

readdir 函数是 Linux 中用于读取目录内容的函数，它定义在 <dirent.h> 头文件中。该函数通常与 opendir 和 closedir 函数一起使用，以打开、读取和关闭目录。

函数原型

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

参数

• 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_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");
        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;
}

注意事项

• readdir 返回的 struct dirent 结构中的 d_name 字段是一个以 null 结尾的字符串，表示目录项的名称。
• readdir 函数返回的指针指向的是 DIR 结构内部的数据，因此在调用 readdir 之间不要关闭目录流。
• 如果需要处理符号链接，可以使用 d_type 字段（在某些系统上可用）来检查条目是否为符号链接。

错误处理

在使用 readdir 时，应该注意检查返回值是否为 NULL，并且可以通过 errno 来获取具体的错误信息。常见的错误包括：

• ENOENT: 目录不存在。
• EACCES: 权限不足，无法访问目录。
• EMFILE: 打开的文件描述符太多。
• ENAMETOOLONG: 文件名太长。

通过这些信息，可以更好地理解和处理在使用 readdir 函数时可能遇到的问题。