telldir(3)

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

BIBLIOTECA
Biblioteca C standard (libc, -lc)

SINOPSIS
#include <dirent.h>

long telldir(DIR *dirp);

    Cerințe pentru macrocomenzi de testare a caracteristicilor pentru glibc (consultați feature_test_macros(7)):

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).
Interfață | Atribut | Valoare
telldir() | Siguranța firelor | MT-Safe

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.