JavaScript/Math/log10

الدالة Math.log10()‎ تعيد اللوغاريتم العشري (ذو الأساس 10) للعدد المعطي، أي لو أعادت هذه الدالة القيمة y فسيكون التعبير الرياضي 10^y = x محققًا.

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

Math.log10(x)

x

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

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

اللوغاريتم العشري (ذو الأساس 10) للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة NaN.

الوصف

إذا كانت قيمة الوسيط x سالبةً، فستُعيد هذه الدالة القيمة NaN دومًا.

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

هذه الدالة تكافئ استخدام Math.log(x) / Math.log(10)‎، وللحصول على قيمة log10(e)‎ فاستخدم الثابت Math.LOG10E، الذي هو ‎1 / Math.LN10‎.

أمثلة

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

Math.log10(2);      // 0.3010299956639812
Math.log10(1);      // 0
Math.log10(0);      // -Infinity
Math.log10(-2);     // NaN
Math.log10(100000); // 5

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

يمكن محاكاة الدالة باستخدام الدالة الآتية:

Math.log10 = Math.log10 || function(x) {
  return Math.log(x) * Math.LOG10E;
};

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

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

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

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

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