温馨提示×

debian readdir返回什么

小樊
61
2026-09-13 09:05:22
栏目: 智能运维

在 Debian(以及所有 Linux/Unix 系统)中,readdir 是一个用于读取目录内容的系统调用/库函数,常见于 C 语言编程中。


1. readdir 是什么

readdir 用于遍历一个打开的目录,每次调用返回目录中的一个条目(文件/子目录)。

函数原型(POSIX 标准):

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

2. readdir 返回什么

✅ 成功时

返回一个指向 struct dirent 的指针,表示目录中的一个条目。

struct dirent {
    ino_t          d_ino;      // inode 号
    off_t          d_off;      // 偏移量(非 POSIX 强制)
    unsigned short d_reclen;   // 记录长度
    unsigned char  d_type;     // 文件类型(部分系统支持)
    char           d_name[256];// 文件名
};

常用字段:

  • d_name:文件名(如 "test.txt"、"."、"..")
  • d_type:文件类型(如 DT_REG 普通文件,DT_DIR 目录)

❌ 失败时

返回 NULL,并设置 errno。


⏹ 目录读取结束时

也返回 NULL,但 errno 不变(这是正常结束,不是错误)。


3. 使用示例

DIR *dir = opendir("/tmp");
struct dirent *entry;

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

closedir(dir);

4. 注意事项

  • readdir 不是线程安全的
    线程安全版本是 readdir_r(已不推荐)或 readdir + 加锁
  • 每次调用返回的是静态缓冲区指针,不要 free
  • 目录顺序不保证(不是字母序)

5. Debian 中的特殊说明

Debian 使用的是 glibc,完全遵循 POSIX:

  • readdir 行为与其他 Linux 发行版一致
  • d_type 在 ext4、xfs 等文件系统上可用

如果你是想问:

  • shell 中的 ls 实现?
  • Python 的 os.listdir / os.scandir?
  • Rust / Go 中的等价函数?

可以告诉我具体语言或场景。

0 踩