الفرق بين المراجعتين لصفحة: «PHP/pow»
< PHP
ط استبدال النص - 'PHP/Operators/arithmetic' ب'PHP/arithmetic operators' |
ط استبدال النص - 'PHP/Types/float' ب'PHP/float' |
||
| سطر 20: | سطر 20: | ||
== القيم المعادة == | == القيم المعادة == | ||
تُعاد القيمة <code>base<sup>exp</sup></code> أي قيمة الأساس <code>base</code> مروفوعًا إلى القوة <code>exp</code>. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع [[PHP/Types/integer|عدد صحيح (integer)]]، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد [[PHP | تُعاد القيمة <code>base<sup>exp</sup></code> أي قيمة الأساس <code>base</code> مروفوعًا إلى القوة <code>exp</code>. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع [[PHP/Types/integer|عدد صحيح (integer)]]، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد [[PHP/float|عشريًّا (float)]]. | ||
== أمثلة == | == أمثلة == | ||
مراجعة 03:33، 4 أبريل 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(): رفع أساس عدد إلى قوة عدد آخر.