READDIR(3)

НАЗВАНИЕ
readdir - читает каталог

СИНТАКСИС
#include <sys/types.h>

#include <dirent.h>

struct dirent *readdir(DIR *dir);

ОПИСАНИЕ
Функция readdir() возвращает указатель на следующую запись каталога в структуре dirent, прочитанную из потока каталога. Каталог указан в dir. Функция возвращает NULL по достижении последней записи или если была обнаружена ошибка.

В соответствие с POSIX, структура dirent содержит поле char d_name[] неопределенной длины, с максимальным количеством символов, предшествующих конечному нулевому символу, равным NAME_MAX. Использование других полей отрицательно повлияет на переносимость ваших программ. В POSIX-2001 как расширение XSI описано поле ino_t d_ino. Данные, возвращаемые readdir() могут быть переписаны последующими вызовами readdir() для того же каталожного потока.

ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
Функция readdir() возвращает указатель на структуру dirent или NULL в случае ошибки или по достижении последней записи.

НАЙДЕННЫЕ ОШИБКИ

EBADF
    неверный описатель потока каталога dir.

СООТВЕТСТВИЕ СТАНДАРТАМ
SVID 3, POSIX, BSD 4.3

СМ. ТАКЖЕ
read(2), closedir(3), dirfd(3), opendir(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)