الفرق بين المراجعتين ل"PHP/pow"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
ط (أخطاء مطبعيّة) |
||
| (9 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 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> للقيمتين الممرَّرتين إليها. |
== الوصف == | == الوصف == | ||
| سطر 9: | سطر 9: | ||
</syntaxhighlight>تعيد هذه الدالة قيمة الأساس <code>base</code> مرفوعًا إلى القوة <code>exp</code> أي القيمة <code>base<sup>exp</sup></code>. | </syntaxhighlight>تعيد هذه الدالة قيمة الأساس <code>base</code> مرفوعًا إلى القوة <code>exp</code> أي القيمة <code>base<sup>exp</sup></code>. | ||
| − | ملاحظة: قد تفضل استعمال المعامل <code>[[PHP | + | ملاحظة: قد تفضل استعمال المعامل <code>[[PHP/arithmetic operators|**]]</code> وذلك في إصدار PHP 5.6 وما بعده. |
== المعاملات == | == المعاملات == | ||
| سطر 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)]]. |
== أمثلة == | == أمثلة == | ||
| سطر 40: | سطر 40: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/exp|exp()]]</code>: تعيد القيمة <code>e<sup>x</sup></code> حيث <code>x</code> هو المعامل الممرَّر إليها. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/sqrt|sqrt()]]</code>: تعيد الجذر التربيعي للعدد. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/bcpow|bcpow()]]</code>: رفع أساس عدد إلى قوة عدد آخر مع تحديد دقة الرقم بعد الفاصلة. |
| − | * الدالة <code>[[PHP/ | + | * الدالة <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(): رفع أساس عدد إلى قوة عدد آخر.