NUME

telldir - returnează locația curentă în fluxul de directoare

BIBLIOTECA

Biblioteca C standard (libc, -lc)

REZUMAT

#include <dirent.h>

long telldir(DIR *dirp);

telldir():

    _XOPEN_SOURCE
       || /* glibc >= 2.19: */ _DEFAULT_SOURCE
       || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIERE

The telldir() function returns the current location associated with the directory stream dirp.

VALOAREA RETURNATĂ

În caz de succes, funcția telldir() returnează locația curentă în fluxul de directoare. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

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).

STANDARDE

POSIX.1-2008.

ISTORIC

POSIX.1-2001, 4.3BSD.

Până la glibc 2.1.1, tipul de returnare al telldir() era off_t. POSIX.1-2001 specifică long, iar acesta este tipul utilizat începând cu glibc 2.1.2.

În primele sisteme de fișiere, valoarea returnată de telldir() era o simplă poziție a fișierului în cadrul unui director. Sistemele de fișiere moderne utilizează structuri arborescente sau sume de control (hash), mai degrabă decât tabele plate, pentru a reprezenta directoare. Pe astfel de sisteme de fișiere, valoarea returnată de telldir() (și utilizată intern de readdir(3)) este un „cookie” care este utilizat de către implementare pentru a obține o poziție în cadrul unui director. Programele de aplicație trebuie să trateze această valoare strict ca pe o valoare opacă, fără a face presupuneri cu privire la conținutul său.

CONSULTAȚI ȘI

closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(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.