atan2

Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)

fun atan2(y: Double, x: Double): Double

fun atan2(y: Float, x: Float): Float

Возвращает угол theta полярных координат (r, theta), соответствующих прямоугольным координатам (x, y), вычисляя арктангенс значения y / x; возвращаемое значение — угол в диапазоне от -PI до PI радиан.

Особые случаи:

• atan2(0.0, 0.0) равно 0.0
• atan2(0.0, x) равно 0.0 для x > 0 и PI для x < 0
• atan2(-0.0, x) равно -0.0 для 'x > 0 and -PI for x < 0`
• atan2(y, +Inf) равно 0.0 для 0 < y < +Inf и -0.0 для '-Inf < y < 0`
• atan2(y, -Inf) равно PI для 0 < y < +Inf и -PI для -Inf < y < 0
• atan2(y, 0.0) равно PI/2 для y > 0 и -PI/2 для y < 0
• atan2(+Inf, x) равно PI/2 для конечного xy
• atan2(-Inf, x) равно -PI/2 для конечного x
• atan2(NaN, x) и atan2(y, NaN) равно NaN