seekdir()

QNX SDP8.0C Library ReferenceAPIDeveloper

Set the position for the next read of the directory stream

Synopsis:

#include <dirent.h>

void seekdir( DIR * dirp,
              long int pos );

Arguments:

dirp
A pointer to the directory stream, for which you want to set the current location.
pos
The new position for the directory stream, which you must have obtained from an earlier call to telldir().

Library:

libc

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

Description:

The seekdir() function sets the position of the next readdir() operation on the directory stream specified by dirp to the position specified by pos.

The new position reverts to the one associated with the directory stream when the telldir() operation was performed.

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.

Classification:

POSIX 1003.1 XSI

Safety:
Cancellation pointYes
Signal handlerNo
ThreadNo
Page updated: