atanh, atanhf, atanhl

Вычисляет обратный гиперболический тангенс.

Синтаксис

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

Параметры

x
Значение с плавающей запятой.

Возвращаемое значение

Функции atanh возвращают обратный гиперболический тангенс (гиперболический тангенс дуги) x. Если x значение равно 1 или меньше -1, установлено EDOM значение и errno результатом является тихая NaN. Если x равняется 1 или -1, возвращается положительная или отрицательная бесконечность, а для errno задается значение ERANGE.

Входные данные	Исключение SEH	Исключение _matherr
± QNaN, IND	нет	нет
X ≥ 1; x ≤ -1	нет	нет

Замечания

Поскольку C++ допускает перегрузку, можно вызывать перегрузки atanh, которые принимают и возвращают значения float или long double. В программе C, если вы не используете <макрос tgmath.h> для вызова этой функции, atanh всегда принимает и возвращает.double

Если вы используете <макрос tgmath.h>atanh() , тип аргумента определяет, какая версия функции выбрана. Дополнительные сведения см . в разделе "Математика с универсальным типом".

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Функция	Заголовок C	Заголовок C++
atanh, atanhf, atanhl	<math.h>	<cmath> или <math.h>
atanhМакрос	<tgmath.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

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

См. также

Поддержка математических и плавающих точек
acosh, acoshf, acoshl
asinh, asinhf, asinhl
cosh, coshf, coshl
sinh, sinhf, sinhl
tanh, tanhf, tanhl