función atanh() en C++ STL

El atanh() es una función incorporada en C++ STL que devuelve la tangente hiperbólica inversa de un ángulo dado en radianes. La función pertenece al archivo de encabezado <cmath> .

Sintaxis: 

atanh(data_type x)

Parámetro: esta función acepta un parámetro obligatorio x que especifica el ángulo hiperbólico inverso en radianes que se encuentra en el rango [-1, 1]. El parámetro puede ser de tipo de datos double, float o long double. 

Valor devuelto: esta función devuelve el seno hiperbólico inverso del argumento en radianes según el parámetro pasado en el argumento. Los diferentes valores de retorno se dan en la siguiente tabla: 

Según el estándar C++ 11 , hay varios prototipos disponibles para la función atanh() ,

Se requiere una conversión explícita de (int, float o long double) a double,

Los siguientes programas ilustran el método anterior: 

Ejemplo 1: 

// C++ program to illustrate
// the atanh() function
// all return values
#include <bits/stdc++.h>
using namespace std;
 
// Driver Code
int main()
{
    // Return value when -1<x<1
    int x = 0;
    // Function call to calculate atanh(x) value
    double result = atanh(x);
 
    cout << "atanh(0) = " << result << " radians\n";
    cout << "atanh(0) = " << result * 180 / 3.141592
         << " degrees\n";
 
    // Return value when x=-1
    x = -1;
    result = atanh(x);
 
    cout << "\natanh(-1) = " << result << " radians\n";
    cout << "atanh(-1) = " << result * 180 / 3.141592
         << " degrees\n";
 
    // Return value when x=1
    x = 1;
    result = atanh(x);
 
    cout << "\natanh(1) = " << result << " radians\n";
    cout << "atanh(1) = " << result * 180 / 3.141592
         << " degrees\n";
 
    // Return value when x<-1 or x>1
    x = -2;
    result = atanh(x);
 
    cout << "\natanh(-2) = " << result << " radians\n";
    cout << "atanh(-2) = " << result * 180 / 3.141592
         << " degrees\n";
 
    return 0;
}

atanh(0) = 0 radians
atanh(0) = 0 degrees

atanh(-1) = -inf radians
atanh(-1) = -inf degrees

atanh(1) = inf radians
atanh(1) = inf degrees

atanh(-2) = -nan radians
atanh(-2) = -nan degrees

Errores y excepciones: la función devuelve un mensaje de error de función no coincidente cuando se pasa una string o cualquier otro tipo de datos excepto el que la función exceptúa. 

Ejemplo: 

// C++ program to demonstrate
// the atanh() function
// string passed
#include <bits/stdc++.h>
using namespace std;
 
int main()
{
    string x = "gfg";
 
    // Function call to calculate atanh(x) value
    double result = atanh(x);
 
    cout << "atanh(50.0) = " << result << " radians"
         << endl;
    cout << "atanh(50.0) = " << result * 180 / 3.141592
         << " degrees" << endl;
    return 0;
}

El programa anterior genera un error si no se pasa como argumento ninguna función coincidente para la llamada como string .

Escriba comentarios si encuentra algo incorrecto o si desea compartir más información sobre el tema tratado anteriormente.