TELLDIR(3) | Manualul programatorului Linux | TELLDIR(3) |
NUME¶
telldir - returnează locația curentă în fluxul de directoare
REZUMAT¶
#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
|| /* Începând cu glibc 2.19: */ _DEFAULT_SOURCE
|| /* Versiunile 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ă în mod corespunzător.
ERORI¶
- 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 |
ÎN CONFORMITATE CU¶
POSIX.1-2001, POSIX.1-2008, 4.3BSD.
NOTE¶
În glibc până la versiunea 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)
COLOFON -- NOTà FINALö
Această pagină face parte din versiunea 4.16 a proiectului Linux man-pages. O descriere a proiectului, informații despre raportarea erorilor și cea mai recentă versiune a acestei pagini pot fi găsite la https://www.kernel.org/doc/man-pages/.
TRADUCERE¶
Traducerea în limba română a acestui manual a fost creată 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.
15 septembrie 2017 |