PHP/pow

(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()‎: رفع أساس عدد إلى قوة عدد آخر.

مصادر

• صفحة الدالة pow في توثيق PHP الرسمي.