الاسم¶

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

المكتبة¶

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

موجز¶

#include <sys/types.h>
#include <dirent.h>

int dirfd(DIR *dirp);

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).

المعايير¶

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 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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