Scroll to navigation

fgetc(3) Library Functions Manual fgetc(3)

الاسم

fgetc، getchar، ungetc - الحصول على محرف من ملف

المكتبة

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

موجز

#include <stdio.h>
int fgetc(FILE *stream);
int getchar(void);
int ungetc(int c, FILE *stream);

الوصف

تقرأ fgetc() المحرف التالي من stream وتُرجعه كـ unsigned char مُحوَّل إلى int، أو EOF عند نهاية الملف أو الخطأ.

getchar() مكافئة لـ fgetc(stdin).

تدفع ungetc() c مرة أخرى إلى stream، مُحوَّلًا إلى unsigned char، حيث يكون متاحًا لعمليات القراءة اللاحقة. ستُعاد المحارف المدفوعة مرة أخرى بترتيب عكسي؛ يُضمن إرجاع واحد فقط.

يمكن مزج استدعاءات الدوال الموصوفة هنا مع بعضها البعض ومع استدعاءات دوال إدخال أخرى من مكتبة stdio لنفس دفق الإدخال.

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

قيمة الإرجاع

تُرجع fgetc() و getchar() المحرف المقروء كـ unsigned char مُحوَّل إلى int أو EOF عند نهاية الملف أو الخطأ.

تُرجع ungetc() c عند النجاح، أو EOF عند الخطأ.

عند حدوث خطأ، تُضبط errno للإشارة إلى الخطأ.

الأخطاء

انظر read(2).

السمات

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

الواجهة السمة القيمة
fgetc()، getchar()، ungetc() سلامة الخيوط MT-Safe

المعايير

C11, POSIX.1-2008.

التاريخ

POSIX.1-2001، C89.

ملاحظات

لا يُنصح بمزج استدعاءات دوال الإدخال من مكتبة stdio مع استدعاءات منخفضة المستوى لـ read(2) لواصف الملف المرتبط بدفق الإدخال؛ ستكون النتائج غير محددة وعلى الأرجح ليست ما تريده.

انظر أيضًا

read(2)، write(2)، ferror(3)، fgetwc(3)، fgets(3)، fopen(3)، fread(3)، fseek(3)، getline(3)، gets(3)، getwchar(3)، puts(3)، scanf(3)، ungetwc(3)، unlocked_stdio(3)، feature_test_macros(7)

ترجمة

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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

19 أغسطس 2026 صفحات دليل لينكس 6.20