atanh, , atanhfatanhl

Oblicza odwrotny tangens hiperboliczny.

Składnia

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

Parametry

x
Wartość zmiennoprzecinkowa.

Wartość zwracana

Funkcje atanh zwracają odwrotny tangens hiperboliczny (tangens hiperboliczny łuku) wartości x. Jeśli x wartość jest większa niż 1 lub mniejsza niż -1, jest ustawiona naEDOM, errno a wynik jest cichym parametrem NaN. Jeśli x wartość jest równa 1 lub -1, zwracana jest odpowiednio dodatnia lub ujemna nieskończoność i errno jest ustawiona na ERANGEwartość .

Dane wejściowe	Wyjątek SEH	Wyjątek _matherr
± QNaN, IND	Brak	Brak
X ≥ 1; x ≤ -1	Brak	Brak

Uwagi

Ponieważ język C++ umożliwia przeciążenie, można wywołać przeciążenia atanh tych wartości, które przyjmują i zwracają float lub long double wartości. W programie języka C, chyba że używasz makra <tgmath.h> do wywołania tej funkcji, atanh zawsze przyjmuje i zwraca wartość double.

Jeśli używasz makra <tgmath.h>atanh() , typ argumentu określa, która wersja funkcji jest zaznaczona. Aby uzyskać szczegółowe informacje, zobacz Typy ogólne matematyczne .

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Wymagania

Function	Nagłówek języka C	Nagłówek języka C++
atanh, , atanhfatanhl	<math.h>	<cmath> lub <math.h>
atanh Makro	<tgmath.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

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

Zobacz też

Obsługa obliczeń matematycznych i zmiennoprzecinkowych
acosh, , acoshfacoshl
asinh, , asinhfasinhl
cosh, , coshfcoshl
sinh, , sinhfsinhl
tanh, , tanhftanhl