atanh, atanhfatanhl

Berechnet den umgekehrten hyperbolischen Tangens.

Syntax

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

Parameter

x
Gleitkommawert.

Rückgabewert

Die atanh Funktionen geben den umgekehrten hyperbolischen Tangens (Arc hyperbolic tangens) von x. Wenn x größer als 1 oder kleiner als -1 ist, wird festgelegtEDOM, errno und das Ergebnis ist ein ruhiger NaN. Wenn x gleich 1 oder –1 ist, wird ein positiver bzw. negativer Unendlichkeitswert ausgegeben, und errno wird auf ERANGE gesetzt.

Eingabe	SEH-Ausnahme	_matherr-Ausnahme
± QNaN, IND	none	none
X ≥ 1; x ≤ -1	none	none

Hinweise

Da C++ das Überladen zulässt, können Sie Überladungen von atanh aufrufen, die float oder long double-Werte verwenden und zurückgeben. Wenn Sie in einem C-Programm nicht das <Makro tgmath.h> verwenden, um diese Funktion aufzurufen, atanh wird diese Funktion immer verwendet und zurückgegeben double.

Wenn Sie das Makro <tgmath.h>atanh() verwenden, bestimmt der Typ des Arguments, welche Version der Funktion ausgewählt ist. Ausführliche Informationen finden Sie unter Typgengenerische Mathematik.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Anforderungen

Funktion	C-Header	C++-Header
atanh, atanhfatanhl	<math.h>	<cmath> oder <math.h>
atanh-Makro	<tgmath.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

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

Siehe auch

Mathematische Unterstützung und Gleitkommaunterstützung
acosh, acoshfacoshl
asinh, asinhfasinhl
cosh, coshfcoshl
sinh, sinhfsinhl
tanh, tanhftanhl