dirent.h

dirent.h – plik nagłówkowy w bibliotece POSIX języka C. Udostępnia funkcje, makra, i struktury, które umożliwiają łatwe trawersowanie katalogów.

Funkcje

int closedir(DIR* dirp)

Zamyka strumień katalogowy dirp. Po prawidłowym wykonaniu, funkcja zwraca wartość 0, inaczej zwraca -1 i zapisuje kod błędu w zmiennej errno.

DIR* opendir(const char* dirname)

Otwiera strumień do katalogu znajdującego się pod ścieżką dirname. Po prawidłowym wykonaniu, opendir() zwraca wskaźnik do obiektu typu DIR, inaczej zwraca NULL.

struct dirent* readdir(DIR* dirp)

Zwraca wskaźnik do struktury reprezentującej plik w obecnej pozycji w strumieniu dirp i awansuje pozycję na następny plik w kolejce. Zwrócony wskaźnik do obiektu struct dirrent nie powinien być zwolniony. Jeśli nie ma już więcej plików w katalogu, wartość NULL jest zwrócona. Gdy wystąpi błąd, wartość NULL także jest zwrócona i powód jest zapisany w zmiennej errno.

int readdir_r(DIR* dirp, struct dirent* entry, struct dirent** result)

void rewinddir(DIR* dirp)

Ustawia strumień katalogowy na początek.

void seekdir(DIR* dirp, long int loc)

Zmienia pozycję strumienia katalogowego.

long int telldir(DIR* dirp)

Zwraca aktualną pozycję w strumieniu katalogowym.

Zmienne

Zmienna	Opis
`NAME_MAX` (lub `FILENAME_MAX`)	maksymalny rozmiar tablicy `d_name`

Typy danych

W pliku dirent.h istnieją następujące definicje:

DIR – struktura reprezentująca strumień katalogowy
struct dirent – struktura, która zawiera:
- ino_t d_ino – numer i-węzła pliku
- char d_name[] – nazwa pliku

Na niektórych platformach, struktura struct dirent może mieć także:

off_t d_off – offset pliku
unsigned short int d_reclen – rozmiar struktury
unsigned short int d_namlen – długość pola d_name
unsigned int d_type – typ pliku

Bibliografia

Ta sekcja od 2021-06 zawiera treści, przy których brakuje odnośników do źródeł.

Należy dodać przypisy do treści niemających odnośników do źródeł. Dodanie listy źródeł bibliograficznych jest problematyczne, ponieważ nie wiadomo, które treści one uźródławiają.
Sprawdź w źródłach: Encyklopedia PWN • Google Books • Google Scholar • Federacja Bibliotek Cyfrowych • BazHum • BazTech • RCIN • Internet Archive (texts / inlibrary)
Dokładniejsze informacje o tym, co należy poprawić, być może znajdują się w dyskusji tej sekcji.
Po wyeliminowaniu niedoskonałości należy usunąć szablon {{Dopracować}} z tej sekcji.

Implementacja dirent.h dla systemów Windows – Dirent API for Microsoft Visual Studio. Softgalleria.net. [dostęp 2012-06-26]. (ang.).
Specyfikacja OpenGroup biblioteki dirent.h – dirent.h. opengroup.org. [dostęp 2012-06-26]. (ang.).
Specyfikacja GNU biblioteki dirent.h – dirent. delorie.com. [dostęp 2012-06-26]. (ang.).