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)