atan2f, atan2l, atan2, atan2d32, atan2d64, e atan2d128 Subroutines

Propósito

Computa a tangente de arco.

Sintaxe

#include <math.h>

float atan2f (y, x)
float y, float x;

long double atan2l (y, x)
long double y, long double x;

double atan2 (y, x)
double y, x;
_Decimal32 atan2d32 (y, x)
_Decimal32 y, x;

_Decimal64 atan2d64 (y, x)
_Decimal64 y, x;

_Decimal128 atan2d128 (y, x)
_Decimal128 y, x;

Descrição

O atan2f, atan2l, atan2, atan2d32, atan2d64 e atan2d128 subroutines computam o valor principal da tangente de arco de y/x, usando os sinais de ambos os parâmetros para determinar o quadrante do valor de retorno.

Um aplicativo que deseje verificar situações de erro deve configurar a variável global errno para zero e chamar feclearexceto (FE_ALL_EXCETO) antes de chamar essas funções. No retorno, se errno for nonzero ou fetestexceto (FE_INVÁLIDO | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW) for nonzero, ocorreu um erro.

Parâmetros

Valores De Retorno

Após a conclusão bem-sucedida, o atan2f, atan2l, atan2, atan2d32, atan2d64e atan2d128 retornam o arco tangente de y/x na faixa [-pi, pi] radianos.

Se y for 0 e x for < 0, ± pi é devolvido.

Se y for 0 e x for> 0, 0 é retornado.

Se y for < 0 e x for 0, -pi/2 é retornado.

Se y for> 0 e x for 0, o pi/2 é retornado.

Se x for 0, um erro de pólo não ocorre.

Se x ou y for NaN, será retornado um NaN.

Se o resultado subfluxos, pode ocorrer um erro de intervalo e y/x é retornado.

Se y for 0 e x for -0, ±x será retornado.

Se y for 0 e x for +0, 0 é retornado.

Para valores finitos de ±y > 0, se x for -Inf, ± x é retornado.

Para valores finitos de ±y > 0, se x for + Inf, 0 é retornado.

Para valores finitos de x, se y for ± Inf, o ±x/2 é retornado.

Se y for ± Inf e x for -Inf, ±3pi/4 é retornado.

Se y for ± Inf e x for + Inf, ±pi/4 é retornado.

Se ambos os argumentos forem 0, um erro de domínio não ocorre.