Поделиться через


atanh, , atanhfatanhl

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

Синтаксис

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.

Требования

Function Заголовок C Заголовок C++
atanh, , atanhfatanhl <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, , acoshfacoshl
asinh, , asinhfasinhl
cosh, , coshfcoshl
sinh, , sinhfsinhl
tanh, , tanhftanhl