الاسم

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

#include <stdio.h>
#include <wchar.h>

wint_t fgetwc(FILE *stream);
wint_t getwc(FILE *stream);

الدالة fgetwc() هي المكافئ العريض المحرف للدالة fgetc(3). تقرأ محرفًا عريضًا من stream وتُرجعه. إذا وُصلت نهاية الدفق، أو إذا أصبح ferror(stream) صحيحًا، تُرجع WEOF. إذا حدث خطأ في تحويل المحرف العريض، تضبط errno على EILSEQ وتُرجع WEOF.

الدالة أو الكليّة getwc() تعمل بشكل مماثل لـ fgetwc(). قد تُنفَّذ ككليّة، وقد تُقيِّم معاملها أكثر من مرة. لا يوجد سبب لاستخدامها أبدًا.

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

عند النجاح، تُرجع fgetwc() المحرف العريض التالي من الدفق. وإلا، يُرجع WEOF، وتُضبط errno للإشارة إلى الخطأ.

بعيداً عن المعتاد، هناك

EILSEQ

البيانات المُحصَّلة من دفق الإدخال لا تُشكِّل محرفًا صالحًا.

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

C11, POSIX.1-2008.

POSIX.1-2001، C99.

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

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

fgetws(3)، fputwc(3)، ungetwc(3)، unlocked_stdio(3)

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

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

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