wctomb(3)

الاسم
wctomb - تحويل محرف عريض إلى تسلسل متعدد البايتات

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

موجز
#include <stdlib.h>

int wctomb(char *s, wchar_t wc);

الوصف
إذا لم تكن s فارغة (NULL)، تُحوِّل الدالة wctomb() المحرف العريض wc إلى تمثيله متعدد البايتات وتخزنه في بداية مصفوفة المحارف المشار إليها بواسطة s. تُحدِّث حالة الإزاحة، المخزنة في متغير ثابت مجهول معروف فقط للدالة wctomb()، وتُعيد طول ذلك التمثيل متعدد البايتات، أي عدد البايتات المكتوبة عند s.

سوف تُكتب بايتات بقدر MB_CUR_MAX كحد أقصى في s. يجب على المبرمج التأكد من وجود مساحة كافية لتخزين التسلسل متعدد البايتات في s.

إذا كانت s فارغة (NULL)، تُعيد الدالة wctomb() ضبط حالة الإزاحة، المعروفة فقط لهذه الدالة، إلى الحالة الابتدائية، وتُعيد قيمة غير صفرية إذا كان للترميز حالة إزاحة غير تافهة، أو صفرًا إذا كان الترميز بلا حالة.

قيمة الإرجاع
إذا لم تكن s فارغة (NULL)، تُعيد الدالة wctomb() عدد البايتات التي كُتبت في مصفوفة البايتات عند s. إذا تعذر تمثيل wc كتسلسل متعدد البايتات (وفقًا للإعدادات المحلية الحالية)، تُعاد القيمة -1.

إذا كانت s فارغة (NULL)، تُعيد الدالة wctomb() قيمة غير صفرية إذا كان للترميز حالة إزاحة غير تافهة، أو صفرًا إذا كان الترميز بلا حالة.

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

الإصدارات
تُوفِّر الدالة wcrtomb(3) واجهة أفضل لنفس الوظيفة.

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

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

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

انظر أيضًا
MB_CUR_MAX(3), mblen(3), mbstowcs(3), mbtowc(3), wcrtomb(3), wcstombs(3)

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

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

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