atanh、atanhf、atanhl

2015-06-09

计算反双曲正切。

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

参数

x
浮点值。

返回值

atanh 函数返回 x 的反双曲正切。如果 x 大于 1 或小于 –1，则将 errno 设置为 EDOM 且结果是 quiet NaN。如果 x 等于 1 或 -1，则分别返回正无穷或负无穷且将 errno 设置为 ERANGE。

输入	SEH 异常	Matherr 异常
± QNAN,IND	无	无
X ≥ 1; x ≤ -1	无	无

备注

由于 C++ 允许重载，因此你可以调用采用并返回 float 或 long double 值的 atanh 重载。在 C 程序中，atanh 始终采用并返回 double。

要求

函数	C 标头	C++ 标头
atanh, atanhf, atanhl	<math.h>	<cmath>

有关其他兼容性信息，请参见兼容性。

示例

// 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 );
}