remove(3)

الاسم
remove - حذف ملف أو دليل

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

موجز
#include <stdio.h>

int remove(const char *path);

الوصف
remove() تحذف اسمًا من نظام الملفات. تستدعي unlink(2) للملفات، و rmdir(2) للأدلة.

إذا كان الاسم المحذوف هو آخر رابط لملف ولم تكن أي عمليات تفتح الملف، يُحذف الملف وتُتاح المساحة التي كان يستخدمها لإعادة الاستخدام.

إذا كان الاسم هو آخر رابط لملف، ولكن لا تزال بعض العمليات تفتح الملف، يبقى الملف موجودًا حتى يُغلق آخر واصف ملف يشير إليه.

إذا كان الاسم يشير إلى رابط رمزي، فسَيُزَالُ الرابط.

إذا كان الاسم يشير إلى مقبس أو FIFO أو جهاز، يُحذف الاسم، لكن العمليات التي تفتح الكائن قد تستمر في استخدامه.

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

الأخطاء
الأخطاء التي تحدث هي تلك الخاصة بـ unlink(2) و rmdir(2).

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

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

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

العلل
يمكن أن تتسبب عيوب في البروتوكول الذي يعتمد عليه NFS في اختفاء غير متوقع للملفات التي لا تزال قيد الاستخدام.

انظر أيضًا
rm(1), unlink(1), link(2), mknod(2), open(2), rename(2), rmdir(2), unlink(2), mkfifo(3), symlink(7)

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

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

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