ИМЯ

       telldir - возвращает текущее положение в потоке каталога

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <dirent.h>

       long telldir(DIR *dirp);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

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

ОПИСАНИЕ

       Функция telldir() возвращает текущее положение, связанное с потоком каталога dirp.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       On  success,  the telldir()  function returns the current location in the directory stream.  On error, -1
       is returned, and errno is set to indicate the error.

ОШИБКИ

       EBADF  Неверный дескриптор потока каталога dirp.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌─────────────────────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ Интерфейс                                                           │ Атрибут              │ Значение │
       ├─────────────────────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │ telldir()                                                           │ Безвредность в нитях │ MT-Safe  │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       POSIX.1-2001, POSIX.1-2008, 4.3BSD.

ЗАМЕЧАНИЯ

       Up to glibc 2.1.1, the return type of telldir()  was off_t.  POSIX.1-2001 specifies long, and this is the
       type used since glibc 2.1.2.

       В старых файловых системах возвращаемое telldir() значение было просто файловым смещением в  каталоге.  В
       современных файловых системах для представления каталогов используются структуры деревьев или хэшей, а не
       плоские  таблицы.  В  таких  файловых  системах  значение,  возвращаемое telldir() (и используемое внутри
       readdir(3)) — некая «подсказка», которая используется  реализацией  для  получения  позиции  в  каталоге.
       Прикладные  программы  должны  считать  это  значение  «чёрным  ящиком»  и  не делать предположений о его
       содержимом.

СМ. ТАКЖЕ

       closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3)

ПЕРЕВОД

       Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>,  Dmitry
       Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если  вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                            5 февраля 2023 г.                                     telldir(3)