telldir()

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

Прототип:

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

Аргументы:

dirp

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

Библиотека:

libc

Описание:

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

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

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

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

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

Коды ошибок:

EBADF

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

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

POSIX 1003.1 X/Open Systems Interfaces Extension

Безопасность использования

Точка остановки потока

Да

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Нет

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

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

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