Fonctions atanh, atanhf et atanhl

Entête à inclure

#include <math.h>  // <cmath> en C++

Fonctions atanh, atanhf et atanhl

double atanh( double value );

float atanhf( float value );                      // C99

long double atanhl( long double value );          // C99

Ces trois fonctions permettent de calculer l'arc tangente hyperbolique d'une value comprise entre -1 et 1. En mathématiques, l'arc tangente hyperbolique est la fonction inverse de la fonction tangente hyperbolique.

La différence entre ces trois fonctions réside dans le type de données utilisé pour le paramètre et la valeur de retour (double, float ou long double). Les fonctions atanhf et atanhl ont été ajoutées dans C99.

Paramètre

• value : une valeur, comprise entre -1 et 1, à partir de laquelle calculer l'arc tangente hyperbolique.

Valeur de retour

Ces fonctions renvoient l'arc tangente hyperbolique demandé. Si la valeur absolue de value est supérieure à 1.0, ces fonctions renvoient la valeur NaN (Not a Number), et errno contient le code d'erreur EDOM (Erreur de DOMaine).

Exemple de code

 1 
 2 
 3 
 4 
 5 
 6 
 7 
 8 
 9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 

#include <math.h>
#include <stdio.h>
#include <stdlib.h>


int main() {

    double value;

    printf( "Saisir une valeur entre -1 et 1 : " );
    scanf( "%lf", &value );

    printf( "atanh(%lf) == %lf\n", value, atanh( value ) );
    
    return EXIT_SUCCESS;

}

Il est à noter que la librairie mathématique doit être ajoutée durant l'étape de "link" (édition des liens) de votre exécutable. Cela se réalise en ajoutant l'option -lm à votre compilateur gcc. En cas d'utilisation d'un autre compilateur, je vous renvoie vers la documentation de ce dernier.

$>  gcc -o sample sample.c -lm
$>  ./sample
Saisir une valeur entre -1 et 1 : 0.5
atanh(0.500000) == 0.549306
$> 

Sujets connexes