NAME

telldir — current location of a named directory stream

SYNOPSIS

[XSI]
#include <dirent.h>

long telldir(DIR *dirp);

DESCRIPTION

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

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

RETURN VALUE

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

ERRORS

No errors are defined.

The following sections are informative.

EXAMPLES

None.

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

opendir(3), readdir(3), seekdir(3), the Base Definitions volume of IEEE Std 1003.1-2001 (“POSIX.1”), <dirent.h>

CHANGE HISTORY

First released in Issue 2.

End of informative text. footer end