عرض مصدر PHP/log1p

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

تعيد الدالة <code>log1p()‎</code> القيمة <code>log(1 + x)‎</code>، إذ <code>x</code> هو المعامل الممرَّر إلى الدالة. تختلف هذه الدالة عن الدالة <code>log()‎</code> بأنَّها ذات دقَّة أكبر عندما يقترب <code>x</code> من الصفر.

== الوصف ==
<syntaxhighlight lang="php">
float log1p ( float $number )
</syntaxhighlight>تعيد هذه الدالة‎ القيمة <code>log(1 + number)‎</code> أي اللوغاريتم الطبيعي <code>log<sub>e</sub></code> للقيمة <code>number + 1</code> إذ <code>number</code> هو القيمة العدديَّة الممرَّرة إليها. تُعدُّ هذه الطريقة في الحساب ذات دقَّة أكبر حتى عندما تقترب قيمة <code>number</code> من الصفر، لذا استعمل الدالة <code>log1p(number)‎</code> عندما تقترب قيمة <code>number</code> من الصفر ولا تستعمل الدالة <code>log (1 + number)‎</code> بدلًا من ذلك. ستعيد الدالة <code>log(1 + number)‎</code> آنذاك قيمة <code>log(1)‎</code> وستُهمَل قيمة <code>number</code> لصغرها وهذا عائد لدقَّتها المنخفضة.

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

=== <code>arg</code> ===
القيمة العدديَّة التي ستُجرى عليها العمليَّة.

== القيم المعادة ==
تُعاد القيمة <code>log(1 + number)‎</code> (أي اللوغاريتم الطبيعي للعدد <code>1 + number</code>).

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.3.0
|تتوافر الدالة الآن على جميع المنصات.
|}

== انظر أيضًا ==
* الدالة <code>[[PHP/log10|log10()‎]]</code>: تعيد قيمة اللوغاريتم العشري <code>log<sub>10</sub>(x)‎</code>.
* الدالة <code>[[PHP/log|log()‎]]</code>: تعيد قيمة اللوغاريتم الطبيعي <code>log<sub>e</sub>(x)‎</code>.
* الدالة <code>[[PHP/expm1|expm1()‎]]</code>: تعيد‎ القيمة <code>e<sup>x</sup> - 1</code>. تُعدُّ هذه الطريقة في الحساب ذات دقَّة أكبر حتى عندما تقترب قيمة <code>x</code> من الصفر.

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