Math.atan2()
الدالة Math.atan2()
تعيد معكوس الظل (arctangent) لناتج قسمة الوسيطين الممررين إليها.
البنية العامة
Math.atan2(y, x)
y
العدد الأول.
x
العدد الثاني.
القيمة المعادة
معكوس الظل (arctangent) لناتج قسمة الوسيطين.
الوصف
الدالة Math.atan(x)
تُعيد قيمةً عدديةً بين -π و π، وهذه القيمة تُمثِّل الزاوية θ للزاوية التي تقع بين المحور x والمستقيم المار من المبدأ ومن النقطة (x, y) والمُقاسة عكس عقارب الساعة. لاحظ أنَّ الوسائط المُمرَّرة إلى هذه الدالة هي إحداثيات y أولًا ثم إحداثيات x.
الدالة Math.atan2()
تأخذ قيمتين منفصلتين، x و y، بينما الدالة Math.atan()
تأخذ قيمةً واحدةً هي نسبة المعاملين على بعضها.
لمّا كانت الدالة atan2
هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.atan2()
، إذ لا تستطيع استخدامها كجزء من كائن Math
خاص بك (تذكر أنَّ الكائن Math
ليس له دالةٌ بانية).
أمثلة
Math.atan2(90, 15); // 1.4056476493802699
Math.atan2(15, 90); // 0.16514867741462683
Math.atan2(±0, -0); // ±PI.
Math.atan2(±0, +0); // ±0.
Math.atan2(±0, -x); // ±PI for x > 0.
Math.atan2(±0, x); // ±0 for x > 0.
Math.atan2(-y, ±0); // -PI/2 for y > 0.
Math.atan2(y, ±0); // PI/2 for y > 0.
Math.atan2(±y, -Infinity); // ±PI for finite y > 0.
Math.atan2(±y, +Infinity); // ±0 for finite y > 0.
Math.atan2(±Infinity, x); // ±PI/2 for finite x.
Math.atan2(±Infinity, -Infinity); // ±3*PI/4.
Math.atan2(±Infinity, +Infinity); // ±PI/4.
دعم المتصفحات
الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 1st Edition .