Scroll to navigation

ATAN2(3) Manual do Programador do Linux ATAN2(3)

NOME

atan2, atan2f, atan2l - função de arcotangente de duas variáveis

SINOPSE

#include <math.h>
double atan2(double y, double x);
float atan2f(float y, float x);
long double atan2l(long double y, long double x);

Vincule com -lm.

Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

atan2f(), atan2l():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Desde o glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc versões <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIÇÃO

Estas funções calculam a arcotangente de y/x, usando os sinais dos dois argumentos para determinar o quadrante do resultado.

VALOR DE RETORNO

No caso sucesso, essas funções retornam o valor principal do arcotangente de y/x em radianos; o valor de retorno está no intervalo [-pi, pi].

Se y é +0 (-0) e x é menor que 0, +pi (-pi) é retornado.

Se y é +0 (-0) e x é maior que 0, +0 (-0) é retornado.

Se y é menor que 0 e x é +0 ou -0, -pi/2 é retornado.

Se y é maior que 0 e x é +0 ou -0, pi/2 é retornado.

Se x ou y é NaN, um NaN é retornado.

Se y é +0 (-0) e x é -0, +pi (-pi) é retornado.

Se y é +0 (-0) e x é +0, +0 (-0) é retornado.

Se y é um valor finito maior (menor) que 0 e x é infinito negativo, +pi (-pi) é retornado.

Se y é um valor finito maior (menor) que 0 e x é infinito positivo, +0 (-0) é retornado.

Se y é infinito positivo (infinito negativo) e x é finito, pi/2 (-pi/2) é retornado.

Se y é infinito positivo (infinito negativo) e x é infinito negativo, +3*pi/4 (-3*pi/4) é retornado.

Se y é infinito positivo (infinito negativo) e x é infinito positivo, +pi/4 (-pi/4) é retornado.

ERROS

Ocorre nenhum erro.

ATRIBUTOS

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

Interface Atributo Valor
atan2(), atan2f(), atan2l() Thread safety MT-Safe

DE ACORDO COM

C99, POSIX.1-2001, POSIX.1-2008.

A variante retornando double também está de acordo com SVr4, 4.3BSD, C89.

VEJA TAMBÉM

acos(3), asin(3), atan(3), carg(3), cos(3), sin(3), tan(3)

COLOFÃO

Esta página faz parte da versão 5.10 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO

A tradução para português brasileiro desta página man foi criada por Paulo César Mendes <drpc@ism.com.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.

15 setembro 2017