telldir()

Получить текущее положение в потоке каталога

Прототип:

#include <dirent.h>
long int telldir( DIR *dirp );

Аргументы:

dirp
Поток каталогов, для которого необходимо получить текущее положение

Библиотека:

libc

Описание:

Функция telldir() получает текущее положение, связанное с потоком каталогов dirp.

Значения, возвращаемые telldir(), верны только во время жизни указателя dirp, из которого они получены. В случае вызова rewinddir() в потоке каталогов или при закрытии и переоткрытии каталога смещение, ранее возвращенное telldir(), станет недействительным.

Возвращаемое значение:

Текущее положение указанного потока каталога.

Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EBADF
Аргумент dirp не указывает на открытый поток каталога.

Классификация:

POSIX 1003.1 XSI

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Нет

Тематические ссылки:

closedir(), errno, lstat(), opendir(), readdir(), readdir_r(), rewinddir(), seekdir(), stat()




Предыдущий раздел: Описание API системной библиотеки