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)