.\" -*- 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 wcstombs 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم wcstombs \- تحويل سلسلة محارف عريضة إلى سلسلة محارف متعددة البايت .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBsize_t wcstombs(\fPsize_t dsize; \fB char \fP\fIdest\fP\fB[restrict \fP\fIdsize\fP\fB], const wchar_t *restrict \fP\fIsrc\fP\fB,\fP \fB size_t \fP\fIdsize\fP\fB);\fP .fi .SH الوصف إذا لم يكن \fIdest\fP فارغًا، فإن الدالة \fBwcstombs\fP() تحول سلسلة المحارف العريضة \fIsrc\fP إلى سلسلة محارف متعددة البايت بدءًا من \fIdest\fP. يُكتب على الأكثر \fIdsize\fP بايت إلى \fIdest\fP. يبدأ تسلسل المحارف الموضوع في \fIdest\fP في حالة الإزاحة الأولية. يمكن أن يتوقف التحويل لثلاثة أسباب: .IP \[bu] 3 وُجد محرف عريض لا يمكن تمثيله كتسلسل متعدد البايت (وفقًا للإعدادات المحلية الحالية). في هذه الحالة، يُرجع \fI(size_t)\ \-1\fP. .IP \[bu] حد الطول يُجبر على التوقف. في هذه الحالة، يُرجع عدد البايتات المكتوبة إلى \fIdest\fP، لكن حالة الإزاحة عند هذه النقطة تُفقد. .IP \[bu] سلسلة المحارف العريضة حُولت بالكامل، بما في ذلك المحرف العريض الفارغ الختامي (L\[aq]\[rs]0\[aq]). في هذه الحالة، ينتهي التحويل في حالة الإزاحة الأولية. يُرجع عدد البايتات المكتوبة إلى \fIdest\fP، باستثناء البايت الفارغ الختامي (\[aq]\[rs]0\[aq]). .P يجب على المبرمج التأكد من وجود مساحة لعدد \fIdsize\fP من البايتات على الأقل في \fIdest\fP. .P إذا كان \fIdest\fP فارغًا، يُتجاهل \fIdsize\fP، ويستمر التحويل كما سبق، باستثناء أن البايتات المحولة لا تُكتب إلى الذاكرة، ولا يوجد حد للطول. .P لتجنب الحالة 2 أعلاه، يجب على المبرمج التأكد من أن \fIdsize\fP أكبر من أو يساوي \fIwcstombs(NULL,src,0)+1\fP. .SH "قيمة الإرجاع" تُرجع الدالة \fBwcstombs\fP() عدد البايتات التي تشكل الجزء المحول من تسلسل متعدد البايت، دون تضمين البايت الفارغ الختامي. إذا وُجد محرف عريض لا يمكن تحويله، يُرجع \fI(size_t)\ \-1\fP. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBwcstombs\fP() T} سلامة الخيوط MT\-Safe .TE .SH الإصدارات توفر الدالة \fBwcsrtombs\fP(3) واجهة أفضل لنفس الوظيفة. .SH المعايير C11, POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، C99. .SH ملاحظات يعتمد سلوك \fBwcstombs\fP() على فئة \fBLC_CTYPE\fP للإعدادات المحلية الحالية. .SH "انظر أيضًا" \fBmblen\fP(3), \fBmbstowcs\fP(3), \fBmbtowc\fP(3), \fBwcsrtombs\fP(3), \fBwctomb\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 .