.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, Thomas Koenig <ig25@rz.uni-karlsruhe.de>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetc 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
fgetc, fgets, getchar, ungetc \- إدخال المحارف والسلاسل
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <stdio.h>\fP
.P
\fBint fgetc(FILE *\fP\fIstream\fP\fB);\fP
\fBint getchar(void);\fP
.P
\fBchar *fgets(\fPint size;
\fB            char \fP\fIs\fP\fB[restrict \fP\fIsize\fP\fB], int \fP\fIsize\fP\fB, FILE *restrict \fP\fIstream\fP\fB);\fP
.P
\fBint ungetc(int \fP\fIc\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
.fi
.SH الوصف
تقرأ \fBfgetc\fP() المحرف التالي من \fIstream\fP وتُرجعه كـ \fIunsigned char\fP
مُحوَّل إلى \fIint\fP، أو \fBEOF\fP عند نهاية الملف أو الخطأ.
.P
\fBgetchar\fP() مكافئة لـ \fIfgetc(stdin)\fP.
.P
تقرأ \fBfgets\fP() على الأكثر محرفًا واحدًا أقل من \fIsize\fP من \fIstream\fP
وتخزّنهم في المخزن المؤقت المُشار إليه بـ \fIs\fP. يتوقف القراءة بعد \fBEOF\fP أو
سطر جديد. إذا قُرئ سطر جديد، يُخزَّن في المخزن المؤقت. يُخزَّن بايت فارغ
ختامي (\[aq]\[rs]0\[aq]) بعد آخر محرف في المخزن المؤقت.
.P
تدفع \fBungetc\fP() \fIc\fP مرة أخرى إلى \fIstream\fP، مُحوَّلًا إلى \fIunsigned char\fP، حيث يكون متاحًا لعمليات القراءة اللاحقة. ستُعاد المحارف المدفوعة مرة
أخرى بترتيب عكسي؛ يُضمن إرجاع واحد فقط.
.P
يمكن مزج استدعاءات الدوال الموصوفة هنا مع بعضها البعض ومع استدعاءات دوال
إدخال أخرى من مكتبة \fIstdio\fP لنفس دفق  الإدخال.
.P
للحصول على نظائر غير مقفلة، انظر \fBunlocked_stdio\fP(3).
.SH "قيمة الإرجاع"
تُرجع \fBfgetc\fP() و \fBgetchar\fP() المحرف المقروء كـ \fIunsigned char\fP مُحوَّل
إلى \fIint\fP أو \fBEOF\fP عند نهاية الملف أو الخطأ.
.P
تُرجع \fBfgets\fP() \fIs\fP عند النجاح، وNULL عند الخطأ أو عند حدوث نهاية الملف
بينما لم تُقرأ أي محارف.
.P
تُرجع \fBungetc\fP() \fIc\fP عند النجاح، أو \fBEOF\fP عند الخطأ.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBfgetc\fP()،
\fBfgets\fP()،
\fBgetchar\fP()،
\fBungetc\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، C89.
.SH ملاحظات
لا يُنصح بمزج استدعاءات دوال الإدخال من مكتبة \fIstdio\fP مع استدعاءات منخفضة
المستوى لـ \fBread\fP(2) لواصف الملف المرتبط بدفق الإدخال؛ ستكون النتائج غير
محددة وعلى الأرجح ليست ما تريده.
.SH "انظر أيضًا"
\fBread\fP(2)، \fBwrite\fP(2)، \fBferror\fP(3)، \fBfgetwc\fP(3)، \fBfgetws\fP(3)،
\fBfopen\fP(3)، \fBfread\fP(3)، \fBfseek\fP(3)، \fBgetline\fP(3)، \fBgets\fP(3)،
\fBgetwchar\fP(3)، \fBputs\fP(3)، \fBscanf\fP(3)، \fBungetwc\fP(3)،
\fBunlocked_stdio\fP(3)، \fBfeature_test_macros\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .