fclose(3)

الاسم
fclose - إغلاق دفق

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

موجز
#include <stdio.h>

int fclose(FILE *stream);

الوصف
الدالة fclose() تُفرغ الدفق المشار إليه بواسطة stream (تكتب أي بيانات مخرجات مخبأة باستخدام fflush(3)) وتغلق واصف الملف الأساسي.

سلوك fclose() غير محدد إذا كان المعامل stream مؤشرًا غير قانوني، أو كان واصفًا مُررًا بالفعل إلى استدعاء سابق لـ fclose().

قيمة الإرجاع
عند الإكمال بنجاح، يُعاد 0. وإلا، يُعاد EOF ويُضبط errno للإشارة إلى الخطأ. في كلتا الحالتين، أي وصول لاحق (بما في ذلك استدعاء آخر لـ fclose()) إلى الدفق يؤدي إلى سلوك غير محدد.

الأخطاء

EBADF
    واصف الملف الأساسي لـ stream غير صالح.

قد تفشل الدالة fclose() أيضًا وتضبط errno لأي من الأخطاء المحددة للروتينات close(2) أو write(2) أو fflush(3).

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

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

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

ملاحظات
لاحظ أن fclose() تُفرغ فقط المخازن المؤقتة في مساحة المستخدم المقدمة من مكتبة C. لضمان تخزين البيانات فعليًا على القرص، يجب أيضًا تفريغ مخازن النواة المؤقتة، على سبيل المثال، باستخدام sync(2) أو fsync(2).

انظر أيضًا
close(2), fcloseall(3), fflush(3), fileno(3), fopen(3), setbuf(3)

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

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

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