atanh, atanhf, atanhl

Статья
06/09/2015

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

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 и результатом является несигнальное значение NaN (QNAN). Если x равняется 1 или -1, возвращается положительная или отрицательная бесконечность, а для errno задается значение ERANGE.

Ввод	Исключение SEH	Исключение Matherr
± QNAN,IND	Нет	Нет
X ≥ 1; x ≤ -1	Нет	Нет

Заметки

Поскольку C++ допускает перегрузку, можно вызывать перегрузки atanh, которые принимают и возвращают значения float или long double. В программе на языке 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 );
}