Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

atan2 — função de biblioteca C23

`atan2(double y, double x)` de `<math.h>` devolve o ângulo direcional do ponto `(x, y)` relativamente ao eixo x positivo, em radianos entre `-π` e `π`. A ordem dos argumentos é primeiro `y`, depois `x`.

Versão: C23

Sintaxe

double atan2(double y, double x);

atan2(double y, double x) de <math.h> devolve o ângulo direcional do ponto (x, y) relativamente ao eixo x positivo, em radianos entre -π e π. A ordem dos argumentos é primeiro y, depois x.

Ao contrário de atan(y / x), conserva o quadrante e trata uma direção vertical sem divisão. O exemplo chama realmente atan2(1.0, 0.0) e obtém aproximadamente π/2.

O C23 base permite erro de domínio se ambos os argumentos forem zero; pode ocorrer erro de intervalo se x > 0 e y / x não zero estiver tão perto de zero que o resultado correto sofra underflow. Todas as regras exatas descritas para zeros com sinal, quadrantes de infinitos e NaN são garantias do Annex F para IEC 60559, não do núcleo C23 portátil.

Exemplos

#include <math.h>
#include <stdio.h>

int main(void) {
    double radians = atan2(1.0, 0.0);
    printf("%.3f\n", radians);
    return 0;
}

Resultado

1.571

Ao contrário de `atan(y / x)`, conserva o quadrante e trata uma direção vertical sem divisão. O exemplo chama realmente `atan2(1.0, 0.0)` e obtém aproximadamente `π/2`.

Fontes