TELLDIR(3C) Standard C Library Functions TELLDIR(3C)

NAME

telldir - current location of a named directory stream

SYNOPSIS

#include <dirent.h>

long int telldir(DIR *dirp);

DESCRIPTION

The telldir() function obtains the current location associated with
the directory stream specified by dirp.


If the most recent operation on the directory stream was a
seekdir(3C), the directory position returned from the telldir() is
the same as that supplied as a loc argument for seekdir().

RETURN VALUES

Upon successful completion, telldir() returns the current location of
the specified directory stream.

ERRORS

The telldir() function will fail if:

EOVERFLOW
The current location of the directory cannot be stored
in an object of type long.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+

SEE ALSO

opendir(3C), readdir(3C), seekdir(3C), attributes(7), standards(7)

August 14, 2002 TELLDIR(3C)