ungetwc(3)

الاسم
ungetwc - دفع محرف عريض إلى الخلف على دفق FILE

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

موجز
#include <wchar.h>

wint_t ungetwc(wint_t wc, FILE *stream);

الوصف
الدالة ungetwc() هي المكافئ العريض للدالة ungetc(3). تدفع محرفًا عريضًا إلى الخلف على stream وتعيده.

إذا كان wc هو WEOF، تُعيد WEOF. إذا كان wc محرفًا عريضًا غير صالح، تضبط errno إلى EILSEQ وتُعيد WEOF.

إذا كان wc محرفًا عريضًا صالحًا، يُدفع إلى الخلف على الدفق وبالتالي يصبح متاحًا لعمليات قراءة المحارف العريضة المستقبلية. يُنقص مؤشر موضع الملف بمقدار واحد أو أكثر. يُمسح مؤشر نهاية الملف. لا يتأثر التخزين الداعم للملف.

ملاحظة: لا يجب أن يكون wc آخر محرف عريض قُرئ من الدفق؛ يمكن أن يكون أي محرف عريض صالح آخر.

إذا دعم التنفيذ عمليات دفع خلفي متعددة متتالية، ستُقرأ المحارف العريضة المدفوعة إلى الخلف بترتيب عكسي؛ ومع ذلك، يُضمن مستوى واحد فقط من الدفع الخلفي.

قيمة الإرجاع
تُعيد الدالة ungetwc() wc عند النجاح، أو WEOF عند الفشل.

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

المعايير
C11, POSIX.1-2008.

التاريخ
POSIX.1-2001، C99.

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

انظر أيضًا
fgetwc(3)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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