الدالة log1p()‎ في PHP

(PHP 4 >= 4.1.0, PHP 5, PHP 7)

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

الوصف

float log1p ( float $number )

تعيد هذه الدالة‎ القيمة log(1 + number)‎ أي اللوغاريتم الطبيعي loge للقيمة number + 1 إذ number هو القيمة العدديَّة الممرَّرة إليها. تُعدُّ هذه الطريقة في الحساب ذات دقَّة أكبر حتى عندما تقترب قيمة number من الصفر، لذا استعمل الدالة log1p(number)‎ عندما تقترب قيمة number من الصفر ولا تستعمل الدالة log (1 + number)‎ بدلًا من ذلك. ستعيد الدالة log(1 + number)‎ آنذاك قيمة log(1)‎ وستُهمَل قيمة number لصغرها وهذا عائد لدقَّتها المنخفضة.

المعاملات

arg

القيمة العدديَّة التي ستُجرى عليها العمليَّة.

القيم المعادة

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

سجل التغييرات

الإصدار	الوصف
5.3.0	تتوافر الدالة الآن على جميع المنصات.

انظر أيضًا

• الدالة log10()‎: تعيد قيمة اللوغاريتم العشري log10(x)‎.
• الدالة log()‎: تعيد قيمة اللوغاريتم الطبيعي loge(x)‎.
• الدالة expm1()‎: تعيد‎ القيمة ex - 1. تُعدُّ هذه الطريقة في الحساب ذات دقَّة أكبر حتى عندما تقترب قيمة x من الصفر.

مصادر

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