إغلاق (استدعاء النظام)

توفر مكتبة C القياسية الدالةfclose بالتوقيع ^{[ 1 ]}

int fclose ( FILE * stream );

يُمثَّل الملف بمؤشر الملف stream، وهو عادةً تجريدٌ لمقبضٍ يعتمد على النظام الأساسي لكائن الملف الأساسي. ولذلك، fcloseيُنفَّذ هذا المؤشر دائمًا تقريبًا كاستدعاء مكتبة، والذي بدوره يُغلق الملف باستخدام استدعاء النظام المُناسب. تُمكِّن طبقة التجريد الإضافية هذه الدالة من البقاء قابلةً للنقل عبر بيئاتٍ مختلفة مع توفير نفس الوظائف. يُعيد الاستدعاء الناجح للدالة fcloseالقيمة صفر، ولكن في حالة حدوث خطأ، تُعيد الدالة قيمةً خاطئة EOF(تُعرَّف عادةً بأنها -1). في كلتا الحالتين، يُضمن فصل مؤشر الملف عن الملف، ويجب عدم استخدامه مرةً أخرى بواسطة أي تطبيق.

يتضمن معيار POSIX استدعاءclose النظام، المعلن عنه على النحو التالي ^{[ 2 ]}

int close ( int fildes );

تأخذ الدالة مُعرِّف الملفfildes ، وهو مُعرِّف عددي للملف المفتوح، كمعامل. تسمح هذه الدالة fildesبإعادة استخدام قيمة مُعرِّف الملف للملفات التي تُفتح لاحقًا، وإذا لم يُشر أي مُعرِّف ملف آخر إلى نفس الملف، فسيتم تحرير أي موارد مرتبطة بالملف المفتوح. عند النجاح، closeتُرجع الدالة القيمة صفر. أما في حالة حدوث خطأ، فتُرجع الدالة القيمة -1 وتُسند رمز خطأ مناسبًا إلى المتغير العام errno. في هذه الحالة، تعتمد قيمة مُعرِّف الملف errnoوحالة المتغير fildesجزئيًا على إصدار POSIX الذي يتبعه النظام.

في جميع إصدارات POSIX، errnoتُضبط القيمة على 0 EBADFإذا fildesكان مُعرّف الملف غير صالح. ومن POSIX.1-2001 فصاعدًا، تُضبط على 0 إذا حدث خطأ إدخال/إخراجEIO يعتمد على النظام الأساسي . ^{[ 3 ]} حتى POSIX.1-2017، إذا أُرسلت إشارة إلى العملية وقاطعت استدعاء الدالة ، يفشل الاستدعاء مع 0، ويكون وضع مُعرّف الملف غير مُحدد صراحةً في المعيار. ^{[ 4 ]} لذا، اعتمادًا على التنفيذ، قد يكون مُعرّف الملف قد أُغلق، وفي هذه الحالة لا ينبغي استدعاء الدالة مرة أخرى. أو قد يظل مُعرّف الملف مفتوحًا، مما يعني أنه يجب استدعاء الدالة مرة أخرى.closeEINTRcloseclose

اعتبر المطورون هذا السلوك غير آمن للتطبيقات المحمولة. على وجه الخصوص، قد يتسبب في حدوث تضارب في العمليات في بيئات متعددة الخيوطclose ، حيث قد يُعاد استخدام مُعرّف الملف في خيط مختلف قبل إعادة المحاولة . ^{[ 5 ] [ 6 ]} ولمعالجة هذه المشكلة، يشترط معيار POSIX.1-2024 أنه في حالة مقاطعة استدعاء الدالة close، يمكن أن تنجح الدالة، أو تفشل مع EINTRإبقاء مُعرّف الملف مفتوحًا، أو تفشل مع EINPROGRESSإغلاق مُعرّف الملف. ^{[ 2 ]}