温馨提示×

debian readdir怎么返回

小樊
41
2026-10-13 03:40:47
栏目: 智能运维

在 Debian(Linux) 下,readdir 是 C 语言 中用于读取目录内容的系统调用封装(来自 <dirent.h>)。你问“readdir 怎么返回”,通常可以从 返回值类型 和 使用方式 两方面理解。


一、readdir 的函数原型

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

二、返回值说明(重点)

✅ 成功时

  • 返回一个指向 struct dirent 的指针
  • 该结构体表示目录中的 下一个条目
  • 每次调用返回一个新的目录项(自动推进)

❌ 到达目录末尾

  • 返回 NULL
  • errno 不变

❌ 发生错误

  • 返回 NULL
  • errno 被设置(如 EBADF)

⚠️ 注意:不能用 NULL 区分“结束”和“错误”,必须配合 errno


三、struct dirent 常见字段(Debian / glibc)

struct dirent {
    ino_t          d_ino;     // inode 号
    off_t          d_off;     // 偏移量
    unsigned short d_reclen;  // 记录长度
    unsigned char  d_type;    // 文件类型
    char           d_name[];  // 文件名(以 '\0' 结尾)
};

常用字段:

  • d_name:文件名(字符串)
  • d_type:文件类型(DT_REG、DT_DIR 等)

四、基本使用示例(Debian / Linux)

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

int main() {
    DIR *dir = opendir(".");
    if (!dir) {
        perror("opendir");
        return 1;
    }

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

    closedir(dir);
    return 0;
}

五、常见问题

1️⃣ readdir 返回的是静态内存吗?

是的:

  • 不是线程安全
  • 同一时刻只有一个 struct dirent 有效
  • 多线程环境用 readdir_r(已废弃)或 readdir + 加锁

2️⃣ 要不要释放 readdir 的返回值?

❌ 不要 free

  • 它由 DIR 内部管理
  • 关闭目录时由 closedir 处理

3️⃣ 为什么返回 . 和 ..?

  • readdir 会返回目录中所有条目
  • 包括 .(当前目录)和 ..(上级目录)

六、Debian 下相关变体

函数 说明
readdir 传统接口
readdir_r 线程安全(已不推荐)
getdents 更底层系统调用
scandir 带过滤和排序

如果你是想问:

  • ✅ readdir 在 shell 里怎么用
  • ✅ Python / Go 怎么对应 readdir
  • ✅ 为什么 readdir 返回顺序不对
  • ✅ 如何只返回普通文件

可以直接告诉我你的使用场景。

0 踩