الاسم¶

fgetws - قراءة سلسلة محارف عريضة من دفق FILE

المكتبة¶

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

موجز¶

#include <wchar.h>

wchar_t *fgetws(int n;
         wchar_t ws[restrict n], int n, FILE *restrict stream);

الوصف¶

الدالة fgetws() هي المكافئ عريض المحارف للدالة fgets(3). تقرأ سلسلة محارف من n-1 محرفًا عريضًا على الأكثر في مصفوفة المحارف العريضة المشار إليها بواسطة ws، وتضيف محرفًا عريضًا ختاميًا فارغًا (L'\0'). تتوقف عن قراءة المحارف العريضة بعد مواجهة وتخزين محرف سطر جديد عريض. تتوقف أيضًا عند بلوغ نهاية الدفق.

يجب على المبرمج ضمان وجود مساحة لـ n محرف عريض على الأقل في ws.

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

قيمة الإرجاع¶

الدالة fgetws() تُرجع ws عند النجاح. إذا وُصلت نهاية الدفق بالفعل أو حدث خطأ، تُرجع NULL.

السمات¶

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

المعايير¶

C11, POSIX.1-2008.

التاريخ¶

POSIX.1-2001، C99.

ملاحظات¶

سلوك fgetws() يعتمد على فئة LC_CTYPE من الإعدادات المحلية الحالية.

في غياب معلومات إضافية مرسلة إلى استدعاء fopen(3)، من المعقول توقع أن fgetws() ستقرأ فعليًا سلسلة محارف متعددة البايت من الدفق ثم تحولها إلى سلسلة محارف عريضة.

هذه الدالة غير موثوقة، لأنها لا تسمح بالتعامل بشكل صحيح مع المحارف العريضة الفارغة التي قد تكون موجودة في الإدخال.

انظر أيضًا¶

fgetwc(3), unlocked_stdio(3)

ترجمة¶

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

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

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