NOM
atanh, atanhf, atanhl - Fonctions arctangente 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 (voir
feature_test_macros(7)) :
atanh(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 ||
_ISOC99_SOURCE ; ou cc -std=c99
atanhf(), atanhl(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE>= 600
|| _ISOC99_SOURCE ; ou cc -std=c99
La fonction atanh() calcule l’arctangente 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’arctangente hyperbolique
de x.
Si x est un NaN, la valeur renvoyée et un NaN.
Si x vaut +0 (respectivement, -0), +0 (respectivement, -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 qui 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 BOGUES). Une exception de virgule flottante
divide-by-zero (FE_DIVBYZERO).
CONFORMITÉ
C99, POSIX.1-2001. La variante renvoyant un double est également
conforme à SVr4, BSD 4.3 et C89.
BOGUES
Pour une erreur de pôle, errno est configuré à la valeur EDOM ; POSIX.1
indique qu’elle devrait être configurée à ERANGE.
VOIR AUSSI
acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(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> ».
5 août 2008