الفرق بين المراجعتين لصفحة: «PHP/pow»

من موسوعة حسوب
< PHP
ط استبدال النص - 'PHP/Types/integer' ب'PHP/integer'
ط أخطاء مطبعيّة
 
(3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة)
سطر 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>exp</code>. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع [[PHP/integer|عدد صحيح (integer)]]، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد [[PHP/float|عشريًّا (float)]].
تُعاد القيمة <code>base<sup>exp</sup></code> أي قيمة الأساس <code>base</code> مرفوعًا إلى القوة <code>exp</code>. إن كان كلا المعاملين الممررين إلى الدالة عددين صحيحين موجبين وكان بالإمكان تمثيل النتيجة بنوع [[PHP/integer|عدد صحيح (integer)]]، فسيكون نوع العدد المُعاد صحيحًا. خلا ذلك، سيكون نوع العدد المُعاد [[PHP/float|عشريًّا (float)]].


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


== مصادر ==
== مصادر ==

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

مصادر