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.
Требования
Function | Заголовок 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