Math.log1p()‎

الدالة Math.log1p()‎ تعيد اللوغاريتم الطبيعي (log_e) للقيمة 1 + x للعدد المعطي x.

Math.log1p(x) = ln (1 + x)

البنية العامة

Math.log1p(x)

x

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

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

اللوغاريتم الطبيعي (ذو الأساس e) للعدد المعطي + 1، وإذا كان العدد أصغر من -1 فستُعاد القيمة NaN.

الوصف

لمّا كانت الدالة log1p هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.log1p(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية).

أمثلة

أمثلة عن استخدام الدالة Math.log1p(x)‎:

Math.log1p(1);  // 0.6931471805599453
Math.log1p(0);  // 0
Math.log1p(-1); // -Infinity
Math.log1p(-2); // NaN

تعويض نقص دعم المتصفحات

يمكن محاكاة هذه الدالة باستخدام الشيفرة الآتية:

Math.log1p = Math.log1p || function(x) {
  return Math.log(1 + x);
};

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	38	25	غير مدعومة	25	8

على النقيض من متصفح IE، يدعم متصفح Edge هذه الخاصية.

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.