17370845950

Linux readdir的返回值解析

在Linux系统中,readdir()函数用于遍历指定目录下的内容。其函数声明如下:

#include 

struct dirent *readdir(DIR *dirp);

该函数接收一个指向DIR结构体的指针作为参数,表示已经打开的目录流。函数执行后将返回一个指向dirent结构体的指针,其中包含了当前目录项的相关信息。

dirent结构体的主要成员包括:

struct dirent {
    long d_ino;             // inode编号
    off_t d_off;            // 目录流中的偏移位置
    unsigned short d_reclen; // 文件名长度
    char d_name[];          // 文件名称字符串
};

当readdir()成功读取到目录项时,会返回指向dirent结构体的有效指针;若读取失败或已到达目录末尾,则返回NULL值。

下面展示了一个简单的readdir()使用示例:

#include 
#include 
#include 
#include 

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;
}

此程序首先调用opendir()尝试打开当前目录,并对返回的目录流指针进行有效性检查。随后通过循环调用readdir()逐个获取目录项,在获取不到更多目录项(返回NULL)时结束循环。每个获取到的目录项的文件名都会被打印输出。最后调用closedir()关闭之前打开的目录流资源。