readdir返回值含义解析

linux

小樊

2025-12-25 04:36:08

栏目: 编程语言

readdir 是一个在 C 语言中用于读取目录内容的函数，它的原型定义在 <dirent.h> 头文件中。readdir 函数用于遍历一个打开的目录流，并返回目录中的下一个目录项。

readdir 函数的原型如下：

struct dirent *readdir(DIR *dirp);

参数：

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

返回值：

成功时，readdir 返回一个指向 struct dirent 结构体的指针，该结构体包含了目录项的信息。
如果已经到达目录流的末尾（即没有更多的目录项），则返回 NULL。
如果发生错误，也返回 NULL。

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

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

    // 关闭目录流
    closedir(dir);

    return 0;
}

在这个例子中，程序会打印出当前目录下的所有文件和子目录的名称。注意，. 和 .. 这两个特殊的目录项也会被列出，分别代表当前目录和父目录。如果你不希望看到这两个条目，可以在打印之前进行检查。

readdir返回值含义解析

最新问答

相关标签