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() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
           ou cc -std=c99
       atanhf(), atanhl() :
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
           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

       acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

COLOPHON

       Cette page fait partie de la publication 3.65 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 à <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> ».

                                                11 septembre 2010                                       ATANH(3)