Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

opendir，fdopendir-打开目录

语法

#include <sys/types.h>
#include <dirent.h>

DIR *opendir(const char *name);
DIR *fdopendir(int fd);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

fdopendir()：

Since glibc 2.10:

_POSIX_C_SOURCE>= 200809L

Before glibc 2.10:

_GNU_SOURCE

说明

opendir()函数打开与目录名称相对应的目录流，并返回指向该目录流的指针。流位于目录中的第一项。

fdopendir()函数类似于opendir()，但返回打开文件描述符fd所引用目录的目录流。成功调用fdopendir()之后，fd由实现在内部使用，否则不应由应用程序使用。

返回值

opendir()和fdopendir()函数返回指向目录流的指针。错误时，将返回NULL，并正确设置了errno。

错误说明

EACCES

没有权限。

EBADF

fd不是打开供读取的有效文件描述符。

EMFILE

已达到打开文件描述符数量的每个进程限制。

ENFILE

已达到系统范围内打开文件总数的限制。

ENOENT

目录不存在，或者名称为空字符串。

ENOMEM

内存不足，无法完成操作。

ENOTDIR

名称不是目录。

版本

从2.4版开始，glibc中提供了fdopendir()。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

opendir()存在于SVr4、4.3BSD上，并在POSIX.1-2001中指定。 fdopendir()在POSIX.1-2008中指定。

备注

可以使用readdir(3)从目录流中读取文件名条目。

可以使用dirfd(3)获得目录流的基础文件描述符。

opendir()函数为DIR *底层的文件描述符设置close-on-exec标志。 fdopendir()函数使文件描述符fd的close-on-exec标志设置保持不变。 POSIX.1-200x不确定是否成功调用fdopendir()将为文件描述符fd设置执行时关闭标志。

另外参见

open(2)，closedir(3)，dirfd(3)，readdir(3)，rewinddir(3)，scandir(3)，seekdir(3)，telldir(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。