.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2000, Andries E. Brouwer .\" 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 strfmon 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم strfmon, strfmon_l \- تحويل القيمة النقدية إلى سلسلة نصية .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBssize_t strfmon(\fPsize_t size; \fB char \fP\fIs\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP \fBssize_t strfmon_l(\fPsize_t size; \fB char \fP\fIs\fP\fB[restrict \fP\fIsize\fP\fB], size_t \fP\fIsize\fP\fB, locale_t \fP\fIl\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP .fi .SH الوصف الدالة \fBstrfmon\fP() تُنسّق المبلغ النقدي المُحدد وفقًا للإعدادات المحلية الحالية ومواصفات التنسيق \fIformat\fP وتضع النتيجة في مصفوفة المحارف \fIs\fP ذات \fIsize\fP بايت. .P الدالة \fBstrfmon_l\fP() تؤدي نفس المهمة، لكنها تستخدم الإعدادات المحلية المُحددة بواسطة \fIl\fP. سلوك \fBstrfmon_l\fP() غير مُعرّف إذا كان \fIl\fP هو كائن الإعدادات المحلية الخاص \fBLC_GLOBAL_LOCALE\fP (انظر \fBduplocale\fP(3)) أو لم يكن مقبض كائن إعدادات محلية صالحًا. .P تُنسخ المحارف العادية في \fIformat\fP إلى \fIs\fP دون تحويل. تُقدّم مُحددات التحويل بحرف \[aq]%\[aq]. مباشرة بعده يمكن أن يكون صفر أو أكثر من الأعلام التالية: .TP \fB=\fP\fIf\fP يُستخدم المحرف أحادي البايت \fIf\fP كمحرف تعبئة عددي (ليُستخدم مع دقة يسرى، انظر أدناه). عندما لا يُحدد، يُستخدم محرف المسافة. .TP \fB\[ha]\fP لا تستخدم أي محارف تجميع قد تكون مُعرّفة للإعدادات المحلية الحالية. افتراضيًا، التجميع مُفعّل. .TP \fB(\fP أو \fB+\fP العلم ( يُشير إلى أن المبالغ السالبة يجب أن تُحصر بين قوسين. العلم + يُشير إلى أن العلامات يجب أن تُعالج بالطريقة المبدئية، أي أن المبالغ تُسبق بإشارة الإعدادات المحلية، على سبيل المثال، لا شيء للإيجابي، "\-" للسلبي. .TP \fB!\fP احذف رمز العملة. .TP \fB\-\fP اضبط جميع الحقول إلى اليسار. المبدئي هو الضبط إلى اليمين. .P بعد ذلك، قد يكون هناك عرض حقل: سلسلة محارف رقمية عشرية تُحدد عرض حقل أدنى بالبايت. المبدئي هو 0. نتيجة أصغر من هذا العرض تُحشى بمسافات (على اليسار، ما لم يُعطَ علم الضبط لليسار). .P بعد ذلك، قد يكون هناك دقة يسرى من الشكل "#" متبوعة بسلسلة محارف رقمية عشرية. إذا كان عدد الأرقام على يسار محرف الأساس أصغر من هذا، تُحشى التمثيلية على اليسار بمحرف التعبئة العددي. لا تُحتسب محارف التجميع في عرض الحقل هذا. .P بعد ذلك، قد يكون هناك دقة يمنى من الشكل "." متبوعة بسلسلة محارف رقمية عشرية. يُقرّب المبلغ المُنسّق إلى عدد الأرقام المُحدد قبل التنسيق. المبدئي مُحدد في عنصري \fIfrac_digits\fP و \fIint_frac_digits\fP للإعدادات المحلية الحالية. إذا كانت الدقة اليمنى 0، لا يُطبع أي محرف أساس. (محرف الأساس هنا يُحدد بواسطة \fBLC_MONETARY\fP، وقد يختلف عن ذلك المُحدد بواسطة \fBLC_NUMERIC\fP.) .P أخيرًا، يجب أن تنتهي مواصفات التحويل بمحرف تحويل. محارف التحويل الثلاثة هي .TP \fB%\fP (في هذه الحالة، يجب أن تكون المواصفات بأكملها بالضبط "%%".) ضع محرف \[aq]%\[aq] في سلسلة النتيجة. .TP \fBi\fP يُحوّل وسيط واحد من النوع \fIdouble\fP باستخدام تنسيق العملة الدولي للإعدادات المحلية. .TP \fBn\fP يُحوّل وسيط واحد من النوع \fIdouble\fP باستخدام تنسيق العملة الوطني للإعدادات المحلية. .SH "قيمة الإرجاع" تُرجع الدالة \fBstrfmon\fP() عدد المحارف الموضوعة في المصفوفة \fIs\fP، دون تضمين البايت الختامي الصفري، بشرط أن تسع السلسلة، بما في ذلك البايت الختامي الصفري. وإلا، فإنها تضبط \fIerrno\fP إلى \fBE2BIG\fP، وتُعيد \-1، وتكون محتويات المصفوفة غير مُعرَّفة. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBstrfmon\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) T{ .na .nh \fBstrfmon_l\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001. .SH أمثلة الاستدعاء .P .in +4n .EX strfmon(buf, sizeof(buf), "[%\[ha]=*#6n] [%=*#6i]", 1234.567, 1234.567); .EE .in .P يُخرج .P .in +4n .EX [€ **1234,57] [EUR **1 234,57] .EE .in .P في الإعداد المحلي \fInl_NL\fP. تُنتج الإعدادات المحلية \fIde_DE\fP و\fIde_CH\fP و\fIen_AU\fP و\fIen_GB\fP .P .in +4n .EX [ **1234,57 €] [ **1.234,57 EUR] [ Fr.\& **1234.57] [ CHF **1\[aq]234.57] [ $**1234.57] [ AUD**1,234.57] [ £**1234.57] [ GBP**1,234.57] .EE .in .SH "انظر أيضًا" \fBduplocale\fP(3), \fBsetlocale\fP(3), \fBsprintf\fP(3), \fBlocale\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .