fwide(3)

الاسم
fwide - ضبط وتحديد توجيه دفق FILE

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

موجز
#include <wchar.h>

int fwide(FILE *stream, int mode);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

fwide():
    _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE
        || _POSIX_C_SOURCE >= 200112L

الوصف
عندما يكون mode صفرًا، تحدد الدالة fwide() التوجيه الحالي لـ stream. تُرجع قيمة موجبة إذا كان stream موجهًا نحو المحارف العريضة، أي إذا كان الإدخال/الإخراج بالمحارف العريضة مسموحًا به بينما الإدخال/الإخراج بالمحارف ممنوع. تُرجع قيمة سالبة إذا كان stream موجهًا نحو البايتات—أي إذا كان الإدخال/الإخراج بالمحارف مسموحًا به بينما الإدخال/الإخراج بالمحارف العريضة ممنوع. تُرجع صفرًا إذا لم يكن لـ stream توجيه بعد؛ في هذه الحالة قد تغير عملية الإدخال/الإخراج التالية التوجيه (إلى موجه نحو البايتات إذا كانت عملية إدخال/إخراج بالمحارف، أو إلى موجه نحو المحارف العريضة إذا كانت عملية إدخال/إخراج بالمحارف العريضة).

بمجرد أن يكتسب الدفق توجيهًا، لا يمكن تغييره ويستمر حتى يُغلق الدفق.

عندما يكون mode غير صفري، تحاول الدالة fwide() أولاً ضبط توجيه stream (إلى موجه نحو المحارف العريضة إذا كان mode أكبر من 0، أو إلى موجه نحو البايتات إذا كان mode أقل من 0). ثم تُرجع قيمة تشير إلى التوجيه الحالي، كما هو مذكور أعلاه.

قيمة الإرجاع
تُرجع الدالة fwide() توجيه الدفق، بعد تغييره ربما. القيمة الموجبة تعني موجه نحو المحارف العريضة. القيمة السالبة تعني موجه نحو البايتات. القيمة الصفرية تعني غير محدد.

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

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

ملاحظات
يمكن تنفيذ الإخراج بالمحارف العريضة إلى دفق موجه نحو البايتات عبر الدالة fprintf(3) باستخدام التوجيهات %lc و %ls.

يمكن تنفيذ الإخراج الموجه نحو المحارف إلى دفق موجه نحو المحارف العريضة عبر الدالة fwprintf(3) باستخدام التوجيهات %c و %s.

انظر أيضًا
fprintf(3), fwprintf(3)

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

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

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