table of contents
ATANH(3) | Manuel du programmeur Linux | ATANH(3) |
NOM¶
atanh, atanhf, atanhl - Fonction arc tangente hyperbolique
SYNOPSIS¶
#include <math.h> double atanh(double x);
float atanhf(float x);
long double atanhl(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)) :
atanh() :
ou cc -std=c99
atanhf(), atanhl() :
ou cc -std=c99
DESCRIPTION¶
La fonction atanh() calcule l'arc tangente hyperbolique de x ; c'est-à-dire la valeur dont la tangente hyperbolique vaut x.
VALEUR RENVOYÉE¶
En cas de réussite, ces fonctions renvoient l'arc tangente hyperbolique de x.
Si x est un NaN, la valeur renvoyée est un NaN.
Si x vaut +0 (resp. -0), +0 (resp. -0) est renvoyé.
Si x vaut +1 ou -1, une erreur de pôle se produit et les fonctions renvoient HUGE_VAL, HUGE_VALF ou HUGE_VALL, respectivement avec le signe mathématique correct.
Si la valeur absolue de x est supérieure à 1, une erreur de domaine est produite et un NaN est renvoyé.
ERREURS¶
Consultez math_error(7) pour savoir comment déterminer qu'une erreur est survenue lors de l'appel de ces fonctions.
Les erreurs suivantes peuvent se produire :
- Erreur de domaine : x est inférieur à -1 ou supérieur à +1
- errno prend la valeur EDOM. Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée.
- Erreur de pôle : x vaut +1 ou -1
- errno est configuré à la valeur ERANGE (mais consultez la section des BOGUES). Une exception de virgule flottante division par zéro (FE_DIVBYZERO) est déclenchée.
CONFORMITɶ
C99, POSIX.1-2001. La variante renvoyant un double est également conforme à SVr4, BSD 4.3 et C89.
BOGUES¶
Dans la glibc 2.9 et plus anciennes, lorsqu'une erreur de pôle se produit, errno est définie à EDOM au lieu de ERANGE comme défini dans POSIX. Depuis la version 2.10, la glibc suit POSIX.
VOIR AUSSI¶
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/.
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 à <perkamon-fr@traduc.org>.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».
11 septembre 2010 |