عرض مصدر Ruby/Math/atan2

<noinclude>{{DISPLAYTITLE: التابع <code>Math.atan2‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Math]]
يحسب التابع <code>atan2</code> قيمة معكوس الظل لناتج قسمة المعاملين الممرَّران إليها. يعيد عددًا من المجال <code>PI..PI-</code>.

القيمة المعادة هي الزاوية (بالراديان) المحددة بالمحور السيني (x-axis) الموجب للمستوى الديكارتي، والنقطة المحددة بالإحداثيات (<code>x</code> , <code>y</code>).

مجال التعريف: <code>(‎-INFINITY ، INFINITY)</code>

المجال المقابل: <code>[‎-PI، PI]</code>.
==البنية العامة==
<syntaxhighlight lang="ruby">atan2(y, x)  → Float‎</syntaxhighlight>
==المعاملات==
===<code>y‎</code>===
العدد الأول من جملة الإحداثيات.

=== <code>x</code> ===
العدد الثاني من جملة الإحداثيات.

==القيمة المعادة==
يعاد <nowiki/>[[Ruby/Float|عدد عشري]] يمثِّل قيمة معكوس الظل للعددين <code>y</code> و <code>x</code> يقع ضمن المجال <code>PI..PI-</code>.
==أمثلة==
مثال على استخدام التابع <code>atan2‎</code>:<syntaxhighlight lang="ruby">Math.atan2(-0.0, -1.0) #=> -3.141592653589793
Math.atan2(-1.0, -1.0) #=> -2.356194490192345
Math.atan2(-1.0, 0.0)  #=> -1.5707963267948966
Math.atan2(-1.0, 1.0)  #=> -0.7853981633974483
Math.atan2(-0.0, 1.0)  #=> -0.0
Math.atan2(0.0, 1.0)   #=> 0.0
Math.atan2(1.0, 1.0)   #=> 0.7853981633974483
Math.atan2(1.0, 0.0)   #=> 1.5707963267948966
Math.atan2(1.0, -1.0)  #=> 2.356194490192345
Math.atan2(0.0, -1.0)  #=> 3.141592653589793
Math.atan2(INFINITY, INFINITY)   #=> 0.7853981633974483
Math.atan2(INFINITY, -INFINITY)  #=> 2.356194490192345
Math.atan2(-INFINITY, INFINITY)  #=> -0.7853981633974483
Math.atan2(-INFINITY, -INFINITY) #=> -2.356194490192345‎</syntaxhighlight>
==انظر أيضا==
*التابع <code>[[Ruby/Math/atan|atan]]</code>: يحسب معكوس الظل (arc tangent) للعدد المُمرَّر إليه.
*التابع <code>[[Ruby/Math/atanh|atanh]]</code>: يحسب معكوس الظل القطعي (inverse hyperbolic tangent) للعدد المُمرَّر إليه.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Math.html#method-c-atan2 قسم التابع atan2‎ في الصنف Math‎ في توثيق روبي الرسمي.]