atanh, , atanhfatanhl

Vypočítá inverzní hyperbolický tangens.

Syntaxe

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
Hodnota s plovoucí desetinou čárkou

Vrácená hodnota

Funkce atanh vrací inverzní hyperbolický tangens (arkus hyperbolický tangens) funkce x. Pokud x je větší než 1 nebo menší než -1, errno nastaví se EDOM na hodnotu a výsledek je tichý naN. Pokud x se rovná 1 nebo -1, vrátí se kladné nebo záporné nekonečno a errno je nastaveno na ERANGEhodnotu .

Vstup	Výjimka SEH	Výjimka _matherr
± QNaN, IND	Žádná	Žádná
X ≥ 1; x ≤ -1	Žádná	Žádná

Poznámky

Vzhledem k tomu, že jazyk C++ umožňuje přetížení, můžete volat přetížení atanh , která přebírají a vracejí nebo vrací float hodnoty long double . Pokud v programu jazyka C nepoužíváte <makro tgmath.h> k volání této funkce, atanh vždy přebírá a vrací double.

Pokud použijete <makro tgmath.h>atanh() , typ argumentu určuje, která verze funkce je vybrána. Podrobnosti najdete v tématu Matematika pro obecné typy.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Požadavky

Function	Záhlaví jazyka C	Hlavička jazyka C++
atanh, , atanhfatanhl	<math.h>	<cmath> nebo <math.h>
atanh makro	<tgmath.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

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

Viz také

Podpora pro matematiku a plovoucí desetinou čárku
acosh, , acoshfacoshl
asinh, , asinhfasinhl
cosh, , coshfcoshl
sinh, , sinhfsinhl
tanh, , tanhftanhl