عرض مصدر PHP/log

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

تعيد الدالة <code>log()‎</code> اللوغاريتم الطبيعي <code>log<sub>e</sub></code>، ذو الأساس <code>e</code>، للعدد المُمرَّر إليها. إذا فرضنا أنَّ القيمة التي تعيدها الدالة هي <code>y</code>، فيكون التعبير الرياضي <code>e<sup>y</sup> = x</code> محققًا.

== الوصف ==
<syntaxhighlight lang="php">
float log ( float $arg [, float $base = M_E ] )
</syntaxhighlight>إن حُدِّد المعامل <code>base</code> ومُرِّر إلى الدالة، فستعيد القيمة <code>log<sub>base</sub>(arg)‎</code>؛ إن لم يحدَّد المعامل <code>base</code> فستعيد الدالة اللوغاريتم الطبيعي <code>log<sub>e</sub></code> للمعامل <code>arg</code>.

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

=== <code>arg</code> ===
القيمة العدديَّة المطلوب حساب لوغاريتمها.

=== <code>base</code> ===
أساس اللوغاريتم وهو اختياري. إذا لم يُحدَّد، فستستعمل الدالة القيمة الافتراضيَّة <code>e</code> أي ستحسب اللوغاريتم الطبيعي ذو الأساس <code>e</code>.

== القيم المعادة ==
تُعاد قيمة اللوغاريتم الطبيعي للمعامل <code>arg</code> إن لم يُعطَ المعامل <code>base</code>، أو اللوغاريتم ذو الأساس <code>base</code> للمعامل <code>arg</code>.

== انظر أيضًا ==
* الدالة <code>[[PHP/log10|log10()‎]]</code>: تعيد قيمة اللوغاريتم العشري <code>log<sub>10</sub>()‎</code>.
* الدالة <code>[[PHP/exp|exp()‎]]</code>: تعيد القيمة <code>e<sup>x</sup></code>‎ إذ إنَّ <code>x</code> هو العدد المعطى.
* الدالة <code>[[PHP/pow|pow()‎]]</code>: تعيد القيمة <code>base<sup>exp</sup></code> للعديين المُمرَّرين‎.

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