Scroll to navigation

getdirentries(3) Library Functions Manual getdirentries(3)

NAZWA

getdirentries - odczytuje wpisy z katalogu, w formacie niezależnym od systemu plików

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <dirent.h>
ssize_t getdirentries(int fd, char buf[restrict .nbytes], size_t nbytes,
                      off_t *restrict basep);

Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

getdirentries():


Od glibc 2.19:
_DEFAULT_SOURCE
glibc 2.19 i wcześniejsze:
_BSD_SOURCE || _SVID_SOURCE

OPIS

Wczytuje do buf wpisy z katalogu określonego przez fd. Odczytywanych jest co najwyżej nbytes bajtów. Czytanie rozpoczyna się od przesunięcia *basep i *basep jest przesuwane do nowej pozycji po przeczytaniu.

WARTOŚĆ ZWRACANA

getdirentries() zwraca liczbę przeczytanych bajtów lub zero, gdy próba czytania następuje na końcu katalogu. Gdy wystąpi błąd, zwracane jest -1 i ustawiane errno wskazując błąd.

BŁĘDY

Szczegóły znajdują się z kodzie źródłowym biblioteki linuksowej.

ATRYBUTY

Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

Interfejs Atrybut Wartość
getdirentries() Bezpieczeństwo wątkowe MT-bezpieczne

STANDARDY

BSD.

UWAGI

Należy stosować zamiennik: opendir(3) i readdir(3).

ZOBACZ TAKŻE

lseek(2), open(2)

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list@lists.sourceforge.net.

2 maja 2024 r. Linux man-pages (niewydane)