telldir()

get current location in directory stream 

Function

SYNOPSIS

#include <dirent.h>

long telldir(const 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(), the directory position returned from the telldir() is the same as that supplied as the loc argument for seekdir().

PARAMETERS

dirp 

Is the directory stream, for which current location is to be obtained.

RETURN VALUES

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

CONFORMANCE

UNIX 98.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

None.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
closedir(), opendir(), readdir(), rewinddir(), seekdir()

MKS Toolkit 9.3 Documentation Build 6.