عرض مصدر PHP/pow

<noinclude>{{DISPLAYTITLE:الدالة <code>pow()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تعيد الدالة <code>pow()‎</code> القيمة <code>y<sup>x</sup></code> أي ترفع الأساس <code>y</code> إلى القوة <code>x</code> للقيمتين الممرَّتين إليها.

== الوصف ==
<syntaxhighlight lang="php">
number pow ( number $base , number $exp )
</syntaxhighlight>تعيد هذه الدالة قيمة الأساس <code>base</code> مرفوعًا إلى القوة <code>exp</code> أي القيمة <code>base<sup>exp</sup></code>.

ملاحظة: قد تفضل استعمال المعامل <code>[[PHP/arithmetic operators|**]]</code> وذلك في إصدار PHP 5.6 وما بعده.

== المعاملات ==

=== <code>base</code> ===
الأساس.

=== <code>exp</code> ===
القوة.

== القيم المعادة ==
تُعاد القيمة <code>base<sup>exp</sup></code> أي قيمة الأساس <code>base</code> مروفوعًا إلى القوة <code>exp</code>. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع [[PHP/integer|عدد صحيح (integer)]]، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد [[PHP/float|عشريًّا (float)]].

== أمثلة ==
المثال 1: استعمال الدالة <code>pow()‎</code><syntaxhighlight lang="php">
<?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
?>
</syntaxhighlight>

== ملاحظات ==
* ستحول هذه الدالة أي قيمة تمرَّر إليها إلى عدد حتى القيم غير الأوليَّة، وذلك قد يؤدي في بعض الأحيان إلى الحصول على نتائج غير متوقعة.

== انظر أيضًا ==
* الدالة <code>[[PHP/exp|exp()‎]]</code>: تعيد القيمة <code>e<sup>x</sup></code> حيث <code>x</code> هو المعامل الممرَّر إليها.
* الدالة <code>[[PHP/sqrt|sqrt()‎]]</code>: تعيد الجذر التربيعي للعدد.
* الدالة <code>[[PHP/bcpow|bcpow()‎]]</code>: رفع أساس عدد إلى قوة عدد آخر مع تحديد دقة الرقم بعد الفاصلة.
* الدالة <code>[[PHP/gmp_pow|gmp_pow()‎]]</code>: رفع أساس عدد إلى قوة عدد آخر.

== مصادر ==
* [http://php.net/manual/en/function.pow.php صفحة الدالة pow في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Math]]