telldir()

Get the location associated with the directory stream

Synopsis:

#include <dirent.h>

long int telldir( DIR * dirp );

Arguments:

dirp
The directory stream for which you want to get the current location.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

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

Values returned by telldir() are good only for the lifetime of the DIR pointer, dirp, from which they're derived. If you call rewinddir() on the directory stream, or if you close and reopen the directory, an offset previously returned by telldir() becomes invalid.

Returns:

The current position of the specified directory stream, or -1 if an error occurs ( errno is set).

Errors:

EBADF
The dirp argument doesn't refer to an open directory stream.

Classification:

POSIX 1003.1 XSI

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread No

Last modified: 2013-12-23

comments powered by Disqus