ferror(3)

الاسم
clearerr, feof, ferror - فحص وإعادة تعيين حالة الدفق

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

موجز
#include <stdio.h>

void clearerr(FILE *stream);
int feof(FILE *stream);
int ferror(FILE *stream);

الوصف
الدالة clearerr() تمسح مؤشرات نهاية الملف والخطأ للدفق المشار إليه بـ stream.

الدالة feof() تختبر مؤشر نهاية الملف للدفق المشار إليه بـ stream، وتعيد قيمة غير صفرية إذا كان مضبوطًا. لا يمكن مسح مؤشر نهاية الملف إلا بواسطة الدالة clearerr().

الدالة ferror() تختبر مؤشر الخطأ للدفق المشار إليه بـ stream، وتعيد قيمة غير صفرية إذا كان مضبوطًا. لا يمكن إعادة تعيين مؤشر الخطأ إلا بواسطة الدالة clearerr().

للحصول على نظائر غير مقفلة، انظر unlocked_stdio(3).

قيمة الإرجاع
الدالة feof() تعيد قيمة غير صفرية إذا كان مؤشر نهاية الملف مضبوطًا لـ stream؛ وإلا، تعيد صفرًا.

الدالة ferror() تعيد قيمة غير صفرية إذا كان مؤشر الخطأ مضبوطًا لـ stream؛ وإلا، تعيد صفرًا.

الأخطاء
لا ينبغي أن تفشل هذه الدوال ولا تضبط errno.

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

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

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

ملاحظات
يحدد POSIX.1-2008 أن هذه الدوال لا ينبغي أن تغير قيمة errno إذا كان stream صالحًا.

تحذيرات
عادةً، يجب على البرامج قراءة القيمة المعادة لدالة إدخال، مثل fgetc(3)، قبل استخدام دوال عائلة feof(3). فقط عندما تعيد الدالة القيمة الحارسة EOF يكون من المنطقي التمييز بين نهاية الملف أو خطأ باستخدام feof(3) أو ferror(3).

انظر أيضًا
open(2), fdopen(3), fileno(3), stdio(3), unlocked_stdio(3)

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

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

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