.\" -*- 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 wcsnrtombs 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم wcsnrtombs \- تحويل سلسلة محارف عريضة إلى سلسلة متعددة البايتات .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBsize_t wcsnrtombs(\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\fInwc\fP\fB, size_t \fP\fIdsize\fP\fB, mbstate_t *restrict \fP\fIps\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBwcsnrtombs\fP(): .nf منذ glibc 2.10: _POSIX_C_SOURCE >= 200809L قبل glibc 2.10: _GNU_SOURCE .fi .SH الوصف الدالة \fBwcsnrtombs\fP() تشبه الدالة \fBwcsrtombs\fP(3) باستثناء أن عدد المحارف العريضة المراد تحويلها، بدءًا من \fI*src\fP، محدود بـ \fInwc\fP. .P إذا لم يكن \fIdest\fP NULL، تُحوِّل الدالة \fBwcsnrtombs\fP() على الأكثر \fInwc\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] تم تحويل \fInwc\fP محرفًا عريضًا دون مواجهة محرف عريض فارغ (L\[aq]\[rs]0\[aq])، أو يُجبر حد الحجم على التوقف. في هذه الحالة، يُترك \fI*src\fP يشير إلى المحرف العريض التالي المراد تحويله، ويُعاد عدد البايتات المكتوبة إلى \fIdest\fP. .IP \[bu] تم تحويل سلسلة المحارف العريضة بالكامل، بما في ذلك المحرف العريض الفارغ الختامي (الذي له أثر جانبي بإعادة \fI*ps\fP إلى الحالة الأولية). في هذه الحالة، يُضبط \fI*src\fP على NULL، ويُعاد عدد البايتات المكتوبة إلى \fIdest\fP، باستثناء البايت الفارغ الختامي (\[aq]\[rs]0\[aq]). .P إذا كان \fIdest\fP NULL، يُتجاهل \fIdsize\fP، ويستمر التحويل كما سبق، باستثناء أن البايتات المحولة لا تُكتب إلى الذاكرة، ولا يوجد حد لحجم الوجهة. .P في كلتا الحالتين أعلاه، إذا كان \fIps\fP NULL، تُستخدم حالة مجهولة ثابتة معروفة فقط للدالة \fBwcsnrtombs\fP() بدلاً من ذلك. .P يجب على المبرمج التأكد من وجود مساحة لعدد \fIdsize\fP من البايتات على الأقل في \fIdest\fP. .SH "قيمة الإرجاع" تُرجع الدالة \fBwcsnrtombs\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 \fBwcsnrtombs\fP() T} سلامة الخيوط T{ .na .nh MT\-Unsafe race:wcsnrtombs/!ps T} .TE .SH المعايير POSIX.1\-2008. .SH ملاحظات يعتمد سلوك \fBwcsnrtombs\fP() على فئة \fBLC_CTYPE\fP من الإعدادات المحلية الحالية. .P تمرير NULL كـ \fIps\fP ليس آمنًا في تعدد الخيوط. .SH "انظر أيضًا" \fBiconv\fP(3), \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 .