Scroll to navigation

atan2(3) Library Functions Manual atan2(3)

NOME

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

BIBLIOTECA

Biblioteca matemática (libm, -lm)

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);

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 <= 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

PADRÕES

C11, POSIX.1-2008.

HISTÓRICO

C99, POSIX.1-2001.

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)

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.

2 maio 2024 Linux man-pages (unreleased)