fgetwc(3)

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

المكتبة
مكتبة سي المعيارية (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).
الواجهة | السمة | القيمة
fgetwc()، getwc() | سلامة الخيوط | MT-Safe

المعايير
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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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