atanh(3) Fonction arc tangente hyperbolique

Other Alias

atanhf, atanhl

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.

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 à <[email protected]> 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> ».