atanh, atanhf, atanhl

Calcola la tangente iperbolica inversa.

Sintassi

double atanh( double x );
float atanhf( float x );
long double atanhl( long double x );
#define atanh(X) // Requires C11 or higher

float atanh( float x );  // C++ only
long double atanh( long double x );  // C++ only

Parametri

x
Valore a virgola mobile.

Valore restituito

Le atanh funzioni restituiscono la tangente iperbolica inversa (tangente iperbolica arco) di x. Se x è maggiore di 1 o minore di -1, errno è impostato su EDOM e il risultato è un NaN non interattiva. Se x è uguale a 1 o a -1, viene restituito rispettivamente un infinito positivo o negativo e errno viene impostato su ERANGE.

Input	Eccezione SEH	Eccezione _matherr
± QNaN, IND	Nessuno	Nessuno
X ≥ 1; x ≤ -1	Nessuno	Nessuno

Osservazioni:

Dato che C++ consente l'overload, è possibile chiamare degli overload di atanh che accettino e restituiscano valori float o long double. In un programma C, a meno che non si usi la <macro tgmath.h> per chiamare questa funzione, atanh accetta sempre e restituisce double.

Se si utilizza la <macro tgmath.h>atanh() , il tipo dell'argomento determina quale versione della funzione è selezionata. Per informazioni dettagliate, vedere La matematica generica dei tipi.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Funzione	Intestazione C	Intestazione C++
atanh, atanhf, atanhl	<math.h>	<cmath> o <math.h>
atanh Macro	<tgmath.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// crt_atanh.c
// This program displays the hyperbolic tangent of pi / 4
// and the arc hyperbolic tangent of the result.
//

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

int main( void )
{
   double pi = 3.1415926535;
   double x, y;

   x = tanh( pi / 4 );
   y = atanh( x );
   printf( "tanh( %f ) = %f\n", pi/4, x );
   printf( "atanh( %f ) = %f\n", x, y );
}

tanh( 0.785398 ) = 0.655794
atanh( 0.655794 ) = 0.785398

Vedi anche

Supporto matematico e a virgola mobile
acosh, acoshf, acoshl
asinh, asinhf, asinhl
cosh, coshf, coshl
sinh, sinhf, sinhl
tanh, tanhf, tanhl