1. NOM

atanh, atanhf, atanhl - Fonction arc tangente hyperbolique

2. SYNOPSIS

 
Sélectionnez
#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

3. DESCRIPTION

La fonction atanh() calcule l'arc tangente hyperbolique de x ; c'est-à-dire la valeur dont la tangente hyperbolique vaut x.

4. 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é.

5. 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.

6. CONFORMITÉ

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

7. 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.

8. VOIR AUSSI

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

9. 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/.

10. 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> ».