NUME¶

readdir - citește un director

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <dirent.h>

struct dirent *readdir(DIR *dirp);

DESCRIERE¶

Funcția readdir() returnează un indicator către o structură dirent care reprezintă următoarea intrare de director din fluxul de directoare indicat de dirp. Aceasta returnează NULL dacă se ajunge la sfârșitul fluxului de directoare sau dacă s-a produs o eroare.

În implementarea glibc, structura dirent este definită după cum urmează:

struct dirent {


    ino_t          d_ino;       /* Numărul nodului-i */


    off_t          d_off;       /* Nu este un decalaj; a se vedea mai jos */


    unsigned short d_reclen;    /* Lungimea acestei înregistrări */


    unsigned char  d_type;      /* Tipul de fișier; nu este acceptat


                                   de către toate tipurile de sisteme de fișiere */


    char           d_name[256]; /* Nume de fișier cu terminație nulă */
};

Singurele câmpuri din structura dirent care sunt impuse de POSIX.1 sunt d_name și d_ino. Celelalte câmpuri nu sunt standardizate și nu sunt prezente pe toate sistemele; a se vedea secțiunea VERSIUNI.

Câmpurile structurii dirent sunt următoarele:

d_ino

Acesta este numărul nodului-i al fișierului.

d_off

Valoarea returnată în d_off este aceeași care ar fi returnată prin apelarea telldir(3) la poziția curentă în fluxul de directoare. Rețineți că, în ciuda tipului și numelui său, câmpul d_off este rareori un fel de decalaj de director pe sistemele de fișiere moderne. Aplicațiile trebuie să trateze acest câmp ca pe o valoare opacă, fără a face presupuneri cu privire la conținutul său; consultați și telldir(3).

d_reclen

Aceasta este dimensiunea (în octeți) a înregistrării returnate. Aceasta poate să nu coincidă cu dimensiunea definiției structurii prezentate mai sus; a se vedea secțiunea VERSIUNI.

d_type

Acest câmp conține o valoare care indică tipul de fișier, ceea ce permite evitarea apelării lstat(2) dacă acțiunile ulterioare depind de tipul fișierului.

Atunci când este definit un macro test de caracteristică adecvat (_DEFAULT_SOURCE de la glibc 2.19 sau _BSD_SOURCE la glibc 2.19 și versiunile anterioare), glibc definește următoarele constante macro pentru valoarea returnată în d_type:

În prezent, numai unele sisteme de fișiere (printre care: Btrfs, ext2, ext3 și ext4) au suport complet pentru returnarea tipului de fișier în d_type. Toate aplicațiile trebuie să gestioneze în mod corespunzător o returnare de tip DT_UNKNOWN.

d_name

Acest câmp conține numele de fișier cu terminație nulă; a se vedea secțiunea VERSIUNI.

Datele returnate de readdir() pot fi suprascrise de apeluri ulterioare la readdir() pentru același flux de directoare.

VALOAREA RETURNATö

În caz de succes, readdir() returnează un indicator către o structură dirent. Această structură poate fi alocată static; nu încercați să o eliberați cu free(3).

Dacă se ajunge la sfârșitul fluxului de directoare, se returnează NULL și errno nu este modificată. Dacă apare o eroare, NULL este returnat și errno este configurată pentru a indica eroarea. Pentru a distinge sfârșitul fluxului de o eroare, definiți errno la zero înainte de a apela readdir() și apoi verificați valoarea lui errno dacă este returnat NULL.

ERORI-IEȘIRE¶

EBADF

Descriptor de flux de director nevalid dirp.

ATRIBUTE¶

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

În actuala specificație POSIX.1 (POSIX.1-2008), readdir() nu este necesar să fie sigur pentru fir. Cu toate acestea, în implementările moderne (inclusiv implementarea glibc), apelurile concurente la readdir() care specifică fluxuri de directoare diferite sunt sigure pentru fire. În cazurile în care mai multe fire de execuție trebuie să citească din același flux de directoare, utilizarea readdir() cu sincronizare externă este preferabilă utilizării funcției depreciate readdir_r(3). Se preconizează că o versiune viitoare a POSIX.1 va solicita ca funcția readdir() să fie sigură pentru fire atunci când este utilizată concomitent pe diferite fluxuri de directoare.

VERSIUNI¶

Doar câmpurile d_name și (ca extensie XSI) d_ino sunt specificate în POSIX.1. În afară de Linux, câmpul d_type este disponibil în principal numai pe sistemele BSD. Celelalte câmpuri sunt disponibile pe multe, dar nu pe toate sistemele. Sub glibc, programele pot verifica disponibilitatea câmpurilor care nu sunt definite în POSIX.1 testând dacă macro-urile _DIRENT_HAVE_D_NAMLEN, _DIRENT_HAVE_D_RECLEN, _DIRENT_HAVE_D_OFF sau _DIRENT_HAVE_D_TYPE sunt definite.

fpathconf(fd, _PC_NAME_MAX)

STANDARDE¶

POSIX.1-2008.

ISTORIC¶

POSIX.1-2001, SVr4, 4.3BSD.

NOTE¶

Un flux de directoare este deschis utilizând opendir(3).

Ordinea în care numele de fișiere sunt citite prin apeluri succesive la readdir() depinde de implementarea sistemului de fișiere; este puțin probabil ca numele să fie sortate în vreun fel.

CONSULTAȚI ȘI¶

getdents(2), read(2), closedir(3), dirfd(3), ftw(3), offsetof(3), opendir(3), readdir_r(3), rewinddir(3), scandir(3), seekdir(3), telldir(3)

TRADUCERE¶

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.