Linux readdir函数详解

readdir 函数是 Linux 系统中用于读取目录内容的函数，它定义在 <dirent.h> 头文件中。这个函数允许程序遍历一个目录中的所有条目（文件和子目录）。

函数原型

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

参数

• DIR *dirp：指向一个已经打开的目录流的指针。这个目录流是通过 opendir 函数打开的。

返回值

• 成功时，readdir 返回一个指向 struct dirent 结构的指针，该结构包含了目录中的一个条目的信息。
• 如果到达目录的末尾，返回 NULL。
• 如果发生错误，也返回 NULL，并且可以通过 errno 来确定具体的错误原因。

struct dirent 结构

struct dirent 结构通常包含以下成员：

• long d_ino：目录项的 inode 号。
• off_t d_off：目录项在目录文件中的偏移量。
• unsigned short d_reclen：目录项的长度。
• char d_name[]：目录项的名称，以 null 字符结尾。

使用示例

下面是一个简单的示例，展示如何使用 readdir 函数来遍历一个目录：

#include <stdio.h>
#include <stdlib.h>
#include <dirent.h>
#include <errno.h>

int main(int argc, char *argv[]) {
    DIR *dir;
    struct dirent *entry;

    if (argc != 2) {
        fprintf(stderr, "Usage: %s <directory>
", argv[0]);
        return EXIT_FAILURE;
    }

    dir = opendir(argv[1]);
    if (dir == NULL) {
        perror("opendir");
        return EXIT_FAILURE;
    }

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

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

    return EXIT_SUCCESS;
}

在这个示例中，程序接受一个命令行参数作为目录路径，然后打开该目录并遍历其中的所有条目，打印出每个条目的名称。最后，它关闭目录流。

注意事项

• readdir 返回的 struct dirent 结构中的 d_name 字段是一个以 null 结尾的字符串，它包含了目录项的名称。
• readdir 函数并不保证返回的目录项顺序，除非目录是以某种特定方式组织的（例如，按名称排序）。
• 在使用 readdir 时，应该注意检查返回值是否为 NULL，并且区分是到达目录末尾还是发生了错误。

这个函数是 POSIX 标准的一部分，因此在大多数 Unix-like 系统上都可以使用。