dirfd(3)

الاسم
dirfd - الحصول على واصف ملف دفق الدليل

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#include <sys/types.h>
#include <dirent.h>

int dirfd(DIR *dirp);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

dirfd():
    /* منذ glibc 2.10: */ _POSIX_C_SOURCE >= 200809L
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

الوصف
الدالة dirfd() تُرجع واصف الملف المرتبط بدفق الدليل dirp.

واصف الملف هذا هو المُستخدم داخليًا بواسطة دفق الدليل. ونتيجة لذلك، فهو مفيد فقط للدوال التي لا تعتمد على موضع الملف أو تُغيره، مثل fstat(2) وfchdir(2). سيُغلق آليًا عند استدعاء closedir(3).

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

الأخطاء
يُحدد POSIX.1-2008 خطأين، لا يُرجع أي منهما بواسطة التنفيذ الحالي.

EINVAL
    dirp لا يُشير إلى دفق دليل صالح.

ENOTSUP
    لا يدعم التنفيذ ربط واصف ملف بدليل.

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

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

التاريخ
4.3BSD-Reno (ليس في 4.2BSD).

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

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

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

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