الفرق بين المراجعتين لصفحة: «PHP/pow»
< PHP
ط نقل عبد اللطيف ايمش صفحة PHP/Function/pow إلى PHP/pow: إعادة هيكلة التوثيق |
ط أخطاء مطبعيّة |
||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تعيد الدالة <code>pow()</code> القيمة <code>y<sup>x</sup></code> أي ترفع الأساس <code>y</code> إلى القوة <code>x</code> للقيمتين | تعيد الدالة <code>pow()</code> القيمة <code>y<sup>x</sup></code> أي ترفع الأساس <code>y</code> إلى القوة <code>x</code> للقيمتين الممرَّرتين إليها. | ||
== الوصف == | == الوصف == | ||
| سطر 20: | سطر 20: | ||
== القيم المعادة == | == القيم المعادة == | ||
تُعاد القيمة <code>base<sup>exp</sup></code> أي قيمة الأساس <code>base</code> | تُعاد القيمة <code>base<sup>exp</sup></code> أي قيمة الأساس <code>base</code> مرفوعًا إلى القوة <code>exp</code>. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع [[PHP/integer|عدد صحيح (integer)]]، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد [[PHP/float|عشريًّا (float)]]. | ||
== أمثلة == | == أمثلة == | ||
المراجعة الحالية بتاريخ 19:25، 10 مايو 2018
(PHP 4, PHP 5, PHP 7)
تعيد الدالة pow() القيمة yx أي ترفع الأساس y إلى القوة x للقيمتين الممرَّرتين إليها.
الوصف
number pow ( number $base , number $exp )
تعيد هذه الدالة قيمة الأساس base مرفوعًا إلى القوة exp أي القيمة baseexp.
ملاحظة: قد تفضل استعمال المعامل ** وذلك في إصدار PHP 5.6 وما بعده.
المعاملات
base
الأساس.
exp
القوة.
القيم المعادة
تُعاد القيمة baseexp أي قيمة الأساس base مرفوعًا إلى القوة exp. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع عدد صحيح (integer)، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد عشريًّا (float).
أمثلة
المثال 1: استعمال الدالة pow()
<?php
var_dump(pow(2, 8)); // int(256)
echo pow(-1, 20); // 1
echo pow(0, 0); // 1
echo pow(10, -1); // 0.1
echo pow(-1, 5.5); // PHP >=5.2.2: NAN
echo pow(-1, 5.5); // PHP <5.2.2: -NAN
?>
ملاحظات
- ستحول هذه الدالة أي قيمة تمرَّر إليها إلى عدد حتى القيم غير الأوليَّة، وذلك قد يؤدي في بعض الأحيان إلى الحصول على نتائج غير متوقعة.
انظر أيضًا
- الدالة
exp(): تعيد القيمةexحيثxهو المعامل الممرَّر إليها. - الدالة
sqrt(): تعيد الجذر التربيعي للعدد. - الدالة
bcpow(): رفع أساس عدد إلى قوة عدد آخر مع تحديد دقة الرقم بعد الفاصلة. - الدالة
gmp_pow(): رفع أساس عدد إلى قوة عدد آخر.