.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, Bruno Haible <bruno@clisp.org>
.\" 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 wcsrtombs 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
wcsrtombs \- تحويل سلسلة محارف عريضة إلى سلسلة محارف متعددة البايت
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <wchar.h>\fP
.P
\fBsize_t wcsrtombs(\fPsize_t dsize;
\fB                 char \fP\fIdest\fP\fB[restrict \fP\fIdsize\fP\fB],\fP
\fB                 const wchar_t **restrict \fP\fIsrc\fP\fB,\fP
\fB                 size_t \fP\fIdsize\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP
.fi
.SH الوصف
إذا لم يكن \fIdest\fP NULL، فالدالة \fBwcsrtombs\fP()  تحول سلسلة المحارف العريضة
\fI*src\fP إلى سلسلة محارف متعددة البايت تبدأ عند \fIdest\fP.  يُكتب على الأكثر
\fIdsize\fP بايت إلى \fIdest\fP.  تُحدّث حالة الإزاحة \fI*ps\fP.  يُنفّذ التحويل
فعليًا باستدعاء متكرر لـ \fIwcrtomb(dest, *src, ps)\fP، طالما نجح هذا
الاستدعاء، ثم زيادة \fIdest\fP بعدد البايتات المكتوبة و \fI*src\fP بمقدار واحد.
يمكن أن يتوقف التحويل لثلاثة أسباب:
.IP \[bu] 3
وُوجِه محرف عريض لا يمكن تمثيله كتسلسل متعدد البايتات (وفقًا للمحلية
الحالية). في هذه الحالة، يُترك \fI*src\fP يشير إلى المحرف العريض غير الصالح،
وتُعاد القيمة \fI(size_t)\ \-1\fP، وتُضبط \fIerrno\fP على \fBEILSEQ\fP.
.IP \[bu]
حد الحجم يُجبر على التوقف.  في هذه الحالة، يُترك \fI*src\fP يشير إلى المحرف
العريض التالي المراد تحويله، ويُعاد عدد البايتات المكتوبة إلى \fIdest\fP.
.IP \[bu]
حُوّلت سلسلة المحارف العريضة بالكامل، بما في ذلك المحرف العريض الختامي
الصفري (L\[aq]\[rs]0\[aq])، والذي له أثر جانبي بإعادة \fI*ps\fP إلى الحالة
الأولية.  في هذه الحالة، يُضبط \fI*src\fP على NULL، ويُعاد عدد البايتات
المكتوبة إلى \fIdest\fP، باستثناء البايت الصفري الختامي (\[aq]\[rs]0\[aq]).
.P
إذا كان \fIdest\fP NULL، يُتجاهل \fIdsize\fP، ويستمر التحويل كما سبق، باستثناء أن
البايتات المحولة لا تُكتب إلى الذاكرة، ولا يوجد حد للحجم.
.P
في كلتا الحالتين أعلاه، إذا كان \fIps\fP NULL، تُستخدم حالة مجهولة ثابتة معروفة
فقط للدالة \fBwcsrtombs\fP()  بدلاً من ذلك.
.P
يجب على المبرمج التأكد من وجود مساحة لعدد \fIdsize\fP من البايتات على الأقل في
\fIdest\fP.
.SH "قيمة الإرجاع"
تُرجع الدالة \fBwcsrtombs\fP()  عدد البايتات التي تشكل الجزء المحول من تسلسل
متعدد البايت، دون تضمين البايت الصفري الختامي.  إذا صودف محرف عريض لا يمكن
تحويله، يُعاد \fI(size_t)\ \-1\fP، ويُضبط \fIerrno\fP على \fBEILSEQ\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lb lb lbx
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBwcsrtombs\fP()
T}	سلامة الخيوط	T{
.na
.nh
MT\-Unsafe race:wcsrtombs/!ps
T}
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، C99.
.SH ملاحظات
يعتمد سلوك \fBwcsrtombs\fP()  على فئة \fBLC_CTYPE\fP من الإعدادات المحلية الحالية.
.P
تمرير NULL كـ \fIps\fP ليس آمنًا في تعدد الخيوط.
.SH "انظر أيضًا"
\fBiconv\fP(3), \fBmbsinit\fP(3), \fBwcrtomb\fP(3), \fBwcsnrtombs\fP(3), \fBwcstombs\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .