NOM
atan2, atan2f, atan2l - Fonctions arctangente de deux variables
SYNOPSIS
#include <math.h>
double atan2(double y, double x);
float atan2f(float y, float x);
long double atan2l(long double y, long double x);
Effectuez l’édition des liens avec l’option -lm.
Exigences de macros de test de fonctionnalités pour la glibc (voir
feature_test_macros(7)) :
atan2f(), atan2l(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE>= 600
|| _ISOC99_SOURCE ; ou cc -std=c99
La fonction atan2() calcule le module de l’arctangente de y/x, en
tenant compte des signes des deux variables pour déterminer le quadrant
du résultat.
VALEUR RENVOYÉE
En cas de réussite, ces fonctions renvoient la valeur principale de
l’arctangente de y/x en radians ; la valeur de retour est comprise dans
l’intervalle [-pi, pi].
Si y vaut +0 (respectivement, -0) et x est négatif, +pi est renvoyé
(respectivement, -pi).
Si y vaut +0 (respectivement, -0) et x est positif, +0 (respectivement,
-0) est renvoyé.
Si y est négatif et x vaut +0 ou -0, -pi/2 est renvoyé.
Si y est positif et x vaut +0 ou -0, pi/2 est renvoyé.
Si x ou y est un NaN, un NaN est renvoyé.
Si y vaut +0 (respectivement, -0) et x vaut -0, +pi (respectivement,
-pi) est renvoyé.
Si y vaut +0 (respectivement, -0) et x vaut +0, +0 (respectivement, -0)
est renvoyé.
Si y est une valeur finie positive (respectivement, négative) et x est
une valeur infinie négative, +pi (respectivement, -pi) est renvoyé.
Si y est une valeur finie positive (respectivement, négative) et si x
est une valeur infinie positive, +0 (respectivement, -0) est renvoyé.
Si y est une valeur infinie positive (respectivement, négative) et si x
est une valeur finie, pi/2 (respectivement, -pi/2) est renvoyé.
Si y est une valeur infinie positive (respectivement, négative) et si x
est une valeur infinie négative, +3*pi/4 (respectivement, -3*pi/4) est
renvoyé.
Si y est une valeur infinie positive (respectivement, négative) et si x
est une valeur infinie positive, +pi/4 (respectivement, -pi/4) est
renvoyé.
ERREURS
Aucune erreur ne se produit.
CONFORMITÉ
C99, POSIX.1-2001. La variante renvoyant un double est également
conforme à SVr4, BSD 4.3 et C89.
VOIR AUSSI
acos(3), asin(3), atan(3), carg(3), cos(3), sin(3), tan(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Florentin Duneau <fduneau@gmail.com> et l’équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».
20 novembre 2008