JavaScript/Math/log2

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

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

Math.log2(x)

x

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

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

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

الوصف

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

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

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

أمثلة

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

Math.log2(3);    // 1.584962500721156
Math.log2(2);    // 1
Math.log2(1);    // 0
Math.log2(0);    // -Infinity
Math.log2(-2);   // NaN
Math.log2(1024); // 10

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

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

Math.log2 = Math.log2 || function(x) {
  return Math.log(x) * Math.LOG2E;
};

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

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

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

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

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