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

名称

telldir-返回目录流中的当前位置

语法

#include <dirent.h>

long telldir(DIR *dirp);

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

telldir()：
_XOPEN_SOURCE
|| / * Glibc自2.19开始：* / -_DEFAULT_SOURCE
|| / * Glibc版本

说明

telldir()函数返回与目录流dirp相关联的当前位置。

返回值

成功后，telldir()函数将返回目录流中的当前位置。如果出错，则返回-1，并正确设置errno。

错误说明

EBADF

无效的目录流描述符dirp。

属性

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

遵循规范

POSIX.1-2001，POSIX.1-2008、4.3BSD。

备注

在版本2.1.1之前的glibc中，telldir()的返回类型为off_t。 POSIX.1-2001指定long，这是自glibc 2.1.2以来使用的类型。

在早期的文件系统中，telldir()返回的值是目录中的简单文件偏移量。现代文件系统使用树或哈希结构而不是平面表来表示目录。在此类文件系统上，telldir()返回的值(并由readdir(3)内部使用)是" cookie"，实现可使用该cookie派生目录中的位置。应用程序应严格将其视为不透明值，不对其内容进行任何假设。

另外参见

closeirir(3)，opendir(3)，readdir(3)，rewinddir(3)，scandir(3)，seekdir(3)

出版信息

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