1. NOM

atan2, atan2f, atan2l - Fonction arc tangente de deux variables

2. SYNOPSIS

 
Sélectionnez
#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 (consultez feature_test_macros(7)) :

atan2f(), atan2l() : _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
ou cc -std=c99

3. DESCRIPTION

La fonction atan2() calcule la mesure principale de l'arc tangente de y/x, en tenant compte des signes des deux variables pour déterminer le quadrant du résultat.

4. VALEUR RENVOYÉE

En cas de réussite, ces fonctions renvoient la mesure principale de l'arc tangente de y/x en radians ; la valeur de retour est comprise dans l'intervalle [-pi, pi]. Si y vaut +0 (resp. -0) et x est négatif, +pi est renvoyé (resp. -pi). Si y vaut +0 (resp. -0) et x est positif, +0 (resp. -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 (resp. -0) et x vaut -0, +pi (resp. -pi) est renvoyé. Si y vaut +0 (resp. -0) et x vaut +0, +0 (resp. -0) est renvoyé. Si y est une valeur finie positive (resp. négative) et x est une valeur infinie négative, +pi (resp. -pi) est renvoyé. Si y est une valeur finie positive (resp. négative) et si x est une valeur infinie positive, +0 (resp. -0) est renvoyé. Si y est une valeur infinie positive (resp. négative) et si x est une valeur finie, pi/2 (resp. -pi/2) est renvoyé. Si y est une valeur infinie positive (resp. négative) et si x est une valeur infinie négative, +3*pi/4 (resp. -3*pi/4) est renvoyé. Si y est une valeur infinie positive (resp. négative) et si x est une valeur infinie positive, +pi/4 (resp. -pi/4) est renvoyé.

5. ERREURS

Aucune erreur ne se produit.

6. CONFORMITÉ

C99, POSIX.1-2001. La variante renvoyant un double est également conforme à SVr4, BSD 4.3 et C89.

7. VOIR AUSSI

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

8. COLOPHON

Cette page fait partie de la publication 3.52 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/.

9. TRADUCTION

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».