عرض مصدر Twig/number format

<noinclude>{{DISPLAYTITLE: المرشح number_format في Twig}}</noinclude>
المرشح <code>number_format</code> يعدل تنسيق الأعداد، وهو مغلِّف حول دالة <code>[[PHP/number format|number_format]]</code> الخاصة بلغة [[PHP]]:<syntaxhighlight lang="twig">
{{ 200.35|number_format }}
</syntaxhighlight>يمكن التحكم في عدد المواضع العشرية والنقاط العشرية وفواصل الآلاف باستخدام وسائط إضافية:<syntaxhighlight lang="twig">
{{ 9800.333|number_format(2, '.', ',') }}
</syntaxhighlight>ولتنسيق الأرقام السالبة أو الحسابات الرياضية، تغلَّف التعليمة السابقة بقوسين، وهما مطلوبان بسبب [[Twig/templates#.D8.A7.D9.84.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1.D8.A7.D8.AA|أسبقية العوامل في Twig]]:<syntaxhighlight lang="twig">
{{ -9800.333|number_format(2, '.', ',') }} {# outputs : -9 #}
{{ (-9800.333)|number_format(2, '.', ',') }} {# outputs : -9,800.33 #}
{{  1 + 0.2|number_format(2) }} {# outputs : 1.2 #}
{{ (1 + 0.2)|number_format(2) }} {# outputs : 1.20 #}
</syntaxhighlight>إذا لم تتوفر خيارات صياغة فسيستخدم Twig خيارات التنسيق الافتراضية، وهي:

* لا توجد مواضع عشرية.
* <code>.</code> كفاصلة عشرية.
* <code>,</code> كفاصلة للآلاف. 

يمكن تغيير هذه القيم الافتراضية في توسعة النواة <code>core</code>:<syntaxhighlight lang="php">
$twig = new \Twig\Environment($loader);
$twig->getExtension(\Twig\Extension\CoreExtension::class)->setNumberFormat(3, '.', ',');
</syntaxhighlight>كذلك يمكن تخطي القيم الافتراضية في <code>number_format</code> عند كل استدعاء باستخدام معامِلات إضافية.

== الوسائط ==

* <code>decimal</code>: عدد المواضع العشرية التي يجب عرضها.
* <code>decimal_point</code>: المحرف أو المحارف التي يجب استخدامها للفاصلة العشرية.
* <code>thousand_sep</code>: المحرف أو المحارف التي يجب استخدامها لفاصلة الآلاف.

== انظر أيضًا ==
*[[Twig/intro|مقدمة عن محرك القوالب Twig]]
*[[Twig/advanced|توسيع Twig]]
*[[Twig/internals|المكونات الداخلية لـ Twig]]
*[[Twig/tags|الوسوم في Twig]]
*[[ Twig/filters|المرشحات في Twig]]
== المصادر ==
* [https://twig.symfony.com/doc/3.x/filters/number_format.html صفحة المرشح number_format في توثيق Twig الرسمي]

[[تصنيف:Twig]]
[[تصنيف:Twig Filters]]