الفرق بين المراجعتين ل"PHP/number format"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
هارون-بوكرش (نقاش | مساهمات) |
|||
(مراجعتان متوسطتان بواسطة نفس المستخدم غير معروضتين) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE:الدالة number_format() في PHP}}</noinclude> | + | <noinclude>{{DISPLAYTITLE:الدالة <code>number_format()</code> في PHP}}</noinclude> |
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
− | تُنَسِق الدالة number_format() الأعداد بالآلاف لعرضها. | + | تُنَسِق الدالة <code>number_format()</code> الأعداد بالآلاف لعرضها. |
− | + | == الوصف == | |
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
string number_format ( float $number [, int $decimals = 0 ] ) | string number_format ( float $number [, int $decimals = 0 ] ) | ||
سطر 11: | سطر 11: | ||
− | </syntaxhighlight>تقبل الدالة number_format() معاملًا واحدًا أو معاملين اثنين أو أربعة معاملات (لا تقبل الدالة number_format() ثلاثة معاملات). | + | </syntaxhighlight>تقبل الدالة <code>number_format()</code> معاملًا واحدًا أو معاملين اثنين أو أربعة معاملات (لا تقبل الدالة <code>number_format()</code> ثلاثة معاملات). |
− | * إذا مُرِّرَ إلى الدالة number_format() معاملٌ واحد، فتُنَسِق الأعداد دون كسرها العُشري مع إضافة فاصلة ( | + | * إذا مُرِّرَ إلى الدالة <code>number_format()</code> معاملٌ واحد، فتُنَسِق الأعداد دون كسرها العُشري مع إضافة فاصلة (<code>,</code>) لكل مجموعة آلاف (أي فاصلة بين كل ثلاثة ارقام). |
− | * إذا مُرِّر إلى الدالة number_format() معاملين اثنين، فتُنَسِق الأعداد مع الحفاظ على كسرها العُشري بإضافة نقطة ( | + | * إذا مُرِّر إلى الدالة <code>number_format()</code> معاملين اثنين، فتُنَسِق الأعداد مع الحفاظ على كسرها العُشري بإضافة نقطة (<code>.</code>) قبله، وستُضيف فاصلة (<code>,</code>) لكل مجموعة آلاف (أي فاصلة بين كل ثلاثة ارقام). |
− | * إذا مُرِّرَ إلى الدالة number_format() أربعة معاملات، فتُنَسِق الأعداد بعدد المعامل decimals من الكسور العُشرية مع إضافة المعامل dec_point (بدلًا من | + | * إذا مُرِّرَ إلى الدالة <code>number_format()</code> أربعة معاملات، فتُنَسِق الأعداد بعدد المعامل <code>decimals</code> من الكسور العُشرية مع إضافة المعامل <code>dec_point</code> (بدلًا من <code>.</code>) كفاصلٍ قبله. وستُضيف المعامل <code>thousands_sep</code> كفاصل لكل مجموعة آلاف (أي بدل الفاصلة <code>,</code>). |
− | + | == المعاملات == | |
− | === | + | === <code>number</code> === |
الرقم المُراد تنسيقه. | الرقم المُراد تنسيقه. | ||
− | === | + | === <code>decimals</code> === |
يُحدد عدد االكسور العُشرية. | يُحدد عدد االكسور العُشرية. | ||
− | === | + | === <code>dec_point</code> === |
يُحدد فاصل الكسور العشرية. | يُحدد فاصل الكسور العشرية. | ||
− | === | + | === <code>thousands_sep</code> === |
يُحدد فاصل مجموعة الآلاف. | يُحدد فاصل مجموعة الآلاف. | ||
− | + | == القيم المعادة == | |
− | تُعيد الدالة number_format() نسخة منسقة من المعامل number. | + | تُعيد الدالة <code>number_format()</code> نسخة منسقة من المعامل <code>number</code>. |
− | + | == سجل التغييرات == | |
{| class="wikitable" | {| class="wikitable" | ||
− | + | !الإصدار | |
− | + | !الوصف | |
|- | |- | ||
|7.2.0 | |7.2.0 | ||
− | |عُدِلت الدالة number_format() حتى لا تُعيد القيمة 0-، قبل هذا كانت الدالة تُعيد القيمة 0- لأعداد مثل 0.01-. | + | |عُدِلت الدالة <code>number_format()</code> حتى لا تُعيد القيمة <code>0-</code>، قبل هذا كانت الدالة تُعيد القيمة <code>0-</code> لأعداد مثل <code>0.01-</code>. |
|- | |- | ||
|5.4.0 | |5.4.0 | ||
− | |دعمت الدالة number_format() قيم المعاملات dec_point و thousands_sep المكونة من عدة بايتات. النسخ السابقة كانت تأخذ البايت الأول في الحسبان فقط لقيم المعاملات. | + | |دعمت الدالة <code>number_format()</code> قيم المعاملات <code>dec_point</code> و <code>thousands_sep</code> المكونة من عدة بايتات. النسخ السابقة كانت تأخذ البايت الأول في الحسبان فقط لقيم المعاملات. |
|} | |} | ||
− | + | == أمثلة == | |
+ | المثال 1: مثال بسيط عن الدالة <code>number_format()</code> | ||
− | + | على سبيل المثال، يستعمل التنسيق الفرنسي رقمين للكسور العشرية و فاصلة (<code>,</code>) لفصل الكسر العشري عن العدد وفراغ (' ') لفصل مجموعة الآلاف. المثال التالي يُبين طرق عديدة لتنسيق الأعداد.<syntaxhighlight lang="php"> | |
− | على سبيل المثال، يستعمل التنسيق الفرنسي رقمين للكسور العشرية و فاصلة ( | ||
<?php | <?php | ||
− | |||
$number = 1234.56; | $number = 1234.56; | ||
// التنسيق الإنكليزي (الافتراضي) | // التنسيق الإنكليزي (الافتراضي) | ||
− | |||
$english_format_number = number_format($number); | $english_format_number = number_format($number); | ||
− | |||
// 1,235 | // 1,235 | ||
// التنسيق الفرنسي | // التنسيق الفرنسي | ||
− | |||
$nombre_format_francais = number_format($number, 2, ',', ' '); | $nombre_format_francais = number_format($number, 2, ',', ' '); | ||
− | |||
// 1 234,56 | // 1 234,56 | ||
$number = 1234.5678; | $number = 1234.5678; | ||
− | |||
// التنسيق الإنكليزي دون فاصلٍ للآلاف | // التنسيق الإنكليزي دون فاصلٍ للآلاف | ||
− | |||
$english_format_number = number_format($number, 2, '.', ''); | $english_format_number = number_format($number, 2, '.', ''); | ||
− | |||
// 1234.57 | // 1234.57 | ||
− | |||
?> | ?> | ||
− | |||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | == انظر أيضًا == | |
− | * sprintf(): إعادة سلسلة نصية منسقة. | + | * <code>[[PHP/sprintf|sprintf()]]</code>: إعادة سلسلة نصية منسقة. |
− | * money_format() : تَنسيق رقم للعرض كالعملات. | + | * <code>[[PHP/money format|money_format()]]</code> : تَنسيق رقم للعرض كالعملات. |
− | * sscanf(): إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين. | + | * <code>[[PHP/sscanf|sscanf()]]</code>: إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين. |
− | * printf(): عرض سلسلة نصية منسقة. | + | * <code>[[PHP/printf|printf()]]</code>: عرض سلسلة نصية منسقة. |
− | + | == مصادر == | |
− | * صفحة الدالة number_format في توثيق PHP الرسمي. | + | * [http://php.net/manual/en/function.number-format.php صفحة الدالة number_format في توثيق PHP الرسمي]. |
+ | [[تصنيف:PHP]] | ||
+ | [[تصنيف:PHP Function]] | ||
+ | [[تصنيف:PHP String]] |
المراجعة الحالية بتاريخ 12:16، 8 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تُنَسِق الدالة number_format()
الأعداد بالآلاف لعرضها.
الوصف
string number_format ( float $number [, int $decimals = 0 ] )
string number_format ( float $number , int $decimals = 0 , string $dec_point = "." , string $thousands_sep = "," )
تقبل الدالة number_format()
معاملًا واحدًا أو معاملين اثنين أو أربعة معاملات (لا تقبل الدالة number_format()
ثلاثة معاملات).
- إذا مُرِّرَ إلى الدالة
number_format()
معاملٌ واحد، فتُنَسِق الأعداد دون كسرها العُشري مع إضافة فاصلة (,
) لكل مجموعة آلاف (أي فاصلة بين كل ثلاثة ارقام). - إذا مُرِّر إلى الدالة
number_format()
معاملين اثنين، فتُنَسِق الأعداد مع الحفاظ على كسرها العُشري بإضافة نقطة (.
) قبله، وستُضيف فاصلة (,
) لكل مجموعة آلاف (أي فاصلة بين كل ثلاثة ارقام). - إذا مُرِّرَ إلى الدالة
number_format()
أربعة معاملات، فتُنَسِق الأعداد بعدد المعاملdecimals
من الكسور العُشرية مع إضافة المعاملdec_point
(بدلًا من.
) كفاصلٍ قبله. وستُضيف المعاملthousands_sep
كفاصل لكل مجموعة آلاف (أي بدل الفاصلة,
).
المعاملات
number
الرقم المُراد تنسيقه.
decimals
يُحدد عدد االكسور العُشرية.
dec_point
يُحدد فاصل الكسور العشرية.
thousands_sep
يُحدد فاصل مجموعة الآلاف.
القيم المعادة
تُعيد الدالة number_format()
نسخة منسقة من المعامل number
.
سجل التغييرات
الإصدار | الوصف |
---|---|
7.2.0 | عُدِلت الدالة number_format() حتى لا تُعيد القيمة 0- ، قبل هذا كانت الدالة تُعيد القيمة 0- لأعداد مثل 0.01- .
|
5.4.0 | دعمت الدالة number_format() قيم المعاملات dec_point و thousands_sep المكونة من عدة بايتات. النسخ السابقة كانت تأخذ البايت الأول في الحسبان فقط لقيم المعاملات.
|
أمثلة
المثال 1: مثال بسيط عن الدالة number_format()
على سبيل المثال، يستعمل التنسيق الفرنسي رقمين للكسور العشرية و فاصلة (,
) لفصل الكسر العشري عن العدد وفراغ (' ') لفصل مجموعة الآلاف. المثال التالي يُبين طرق عديدة لتنسيق الأعداد.
<?php
$number = 1234.56;
// التنسيق الإنكليزي (الافتراضي)
$english_format_number = number_format($number);
// 1,235
// التنسيق الفرنسي
$nombre_format_francais = number_format($number, 2, ',', ' ');
// 1 234,56
$number = 1234.5678;
// التنسيق الإنكليزي دون فاصلٍ للآلاف
$english_format_number = number_format($number, 2, '.', '');
// 1234.57
?>
انظر أيضًا
sprintf()
: إعادة سلسلة نصية منسقة.money_format()
: تَنسيق رقم للعرض كالعملات.sscanf()
: إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين.printf()
: عرض سلسلة نصية منسقة.