.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, Bruno Haible .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH wcrtomb 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم wcrtomb \- تحويل محرف عريض إلى تسلسل متعدد البايتات .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBsize_t wcrtomb(char *restrict \fP\fIs\fP\fB, wchar_t \fP\fIwc\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP .fi .SH الوصف الحالة الرئيسية لهذه الدالة هي عندما لا يكون \fIs\fP NULL ولا يكون \fIwc\fP محرفًا عريضًا فارغًا (L\[aq]\[rs]0\[aq]). في هذه الحالة، تحوِّل الدالة \fBwcrtomb\fP() المحرف العريض \fIwc\fP إلى تمثيله متعدد البايتات وتخزنه في بداية مصفوفة المحارف المشار إليها بـ \fIs\fP. تُحدِّث حالة الإزاحة \fI*ps\fP، وتُعيد طول ذلك التمثيل متعدد البايتات، أي عدد البايتات المكتوبة عند \fIs\fP. .P حالة مختلفة هي عندما لا يكون \fIs\fP NULL، لكن \fIwc\fP هو محرف عريض فارغ (L\[aq]\[rs]0\[aq]). في هذه الحالة، تخزِّن الدالة \fBwcrtomb\fP() في مصفوفة المحارف المشار إليها بـ \fIs\fP تسلسل الإزاحة اللازم لإعادة \fI*ps\fP إلى الحالة الأولية، متبوعًا ببايت \[aq]\[rs]0\[aq]. تُحدِّث حالة الإزاحة \fI*ps\fP (أي تعيدها إلى الحالة الأولية)، وتُعيد طول تسلسل الإزاحة زائد واحد، أي عدد البايتات المكتوبة عند \fIs\fP. .P حالة ثالثة هي عندما يكون \fIs\fP NULL. في هذه الحالة، يُتجاهل \fIwc\fP، وتُعيد الدالة فعليًا .P .in +4n .EX wcrtomb(buf, L\[aq]\[rs]0\[aq], ps) .EE .in .P حيث \fIbuf\fP هو مخبأ داخلي مجهول. .P في جميع الحالات المذكورة أعلاه، إذا كان \fIps\fP NULL، يُستخدم حالة ثابتة مجهولة معروفة فقط للدالة \fBwcrtomb\fP() بدلاً من ذلك. .P سوف تُكتب بايتات بقدر \fBMB_CUR_MAX\fP كحد أقصى في \fIs\fP. يجب على المبرمج التأكد من وجود مساحة كافية لتخزين التسلسل متعدد البايتات في \fIs\fP. .SH "قيمة الإرجاع" تُعيد الدالة \fBwcrtomb\fP() عدد البايتات التي كُتبت أو كانت ستُكتب إلى مصفوفة البايتات عند \fIs\fP. إذا تعذر تمثيل \fIwc\fP كتسلسل متعدد البايتات (وفقًا للإعدادات المحلية الحالية)، يُعاد \fI(size_t)\ \-1\fP، ويُضبط \fIerrno\fP على \fBEILSEQ\fP. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBwcrtomb\fP() T} سلامة الخيوط MT\-Unsafe race:wcrtomb/!ps .TE .SH المعايير C11, POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، C99. .SH ملاحظات يعتمد سلوك \fBwcrtomb\fP() على فئة \fBLC_CTYPE\fP للإعدادات المحلية الحالية. .P تمرير NULL كـ \fIps\fP ليس آمنًا في تعدد الخيوط. .SH "انظر أيضًا" \fBmbsinit\fP(3), \fBwcsrtombs\fP(3) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .