telldir(3)

الاسم
telldir - إرجاع الموقع الحالي في دفق الدليل

المكتبة
مكتبة سي المعيارية (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.

قيمة الإرجاع
عند النجاح، تُرجع الدالة telldir() الموقع الحالي في دفق الدليل. عند الخطأ، يُرجع -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء

EBADF
    واصف تدفق دليل dirp غير صالح.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
telldir() | سلامة الخيوط | MT-Safe

المعايير
POSIX.1-2008.

التاريخ
POSIX.1-2001، 4.3BSD.

حتى glibc 2.1.1، كان نوع الإرجاع للدالة telldir() هو off_t. يحدد POSIX.1-2001 النوع long، وهذا هو النوع المستخدم منذ glibc 2.1.2.

في أنظمة الملفات المبكرة، كانت القيمة التي تُرجعها telldir() عبارة عن إزاحة ملف بسيطة داخل دليل. تستخدم أنظمة الملفات الحديثة هياكل شجرية أو تجزئة، بدلاً من الجداول المسطحة، لتمثيل الأدلة. في مثل هذه الأنظمة، القيمة التي تُرجعها telldir() (وتُستخدم داخليًا بواسطة readdir(3)) هي "كعكة" تُستخدم بواسطة التنفيذ لاشتقاق موضع داخل دليل. يجب على برامج التطبيقات معاملة هذا بدقة كقيمة غير شفافة، دون أي افتراضات حول محتوياتها.

انظر أيضًا
closedir(3), opendir(3), readdir(3), rewinddir(3), scandir(3), seekdir(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.