.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, Bruno Haible <bruno@clisp.org>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetws 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
fgetws \- قراءة سلسلة محارف عريضة من دفق FILE
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *fgetws(\fPint n;
\fB         wchar_t \fP\fIws\fP\fB[restrict \fP\fIn\fP\fB], int \fP\fIn\fP\fB, FILE *restrict \fP\fIstream\fP\fB);\fP
.fi
.SH الوصف
الدالة \fBfgetws\fP()  هي المكافئ عريض المحارف للدالة \fBfgets\fP(3).  تقرأ سلسلة
محارف من \fIn\-1\fP محرفًا عريضًا على الأكثر في مصفوفة المحارف العريضة المشار
إليها بواسطة \fIws\fP، وتضيف محرفًا عريضًا ختاميًا فارغًا (L\[aq]\[rs]0\[aq]).
تتوقف عن قراءة المحارف العريضة بعد مواجهة وتخزين محرف سطر جديد عريض.  تتوقف
أيضًا عند بلوغ نهاية الدفق.
.P
يجب على المبرمج ضمان وجود مساحة لـ \fIn\fP محرف عريض على الأقل في \fIws\fP.
.P
للحصول على نظير غير مقفل، انظر \fBunlocked_stdio\fP(3).
.SH "قيمة الإرجاع"
الدالة \fBfgetws\fP()  تُرجع \fIws\fP عند النجاح.  إذا وُصلت نهاية الدفق بالفعل أو
حدث خطأ، تُرجع NULL.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBfgetws\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، C99.
.SH ملاحظات
سلوك \fBfgetws\fP()  يعتمد على فئة \fBLC_CTYPE\fP من الإعدادات المحلية الحالية.
.P
في غياب معلومات إضافية مرسلة إلى استدعاء \fBfopen\fP(3)، من المعقول توقع أن
\fBfgetws\fP()  ستقرأ فعليًا سلسلة محارف متعددة البايت من الدفق ثم تحولها إلى
سلسلة محارف عريضة.
.P
هذه الدالة غير موثوقة، لأنها لا تسمح بالتعامل بشكل صحيح مع المحارف العريضة
الفارغة التي قد تكون موجودة في الإدخال.
.SH "انظر أيضًا"
\fBfgetwc\fP(3), \fBunlocked_stdio\fP(3)
.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 .