atanh - вычисление функции обратного гиперболического
atanh(3)
вычисление функции обратного гиперболического
Other Alias
atanhf, atanhl
ОБЗОР
#include <math.h>
double atanh(double x);
float atanhf(float x);
long double atanhl(long double x);
Компонуется при указании параметра
-lm.
Требования макроса тестирования свойств для glibc
(см. feature_test_macros(7)):
atanh():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или
cc -std=c99
atanhf(),
atanhl():
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE
|| _POSIX_C_SOURCE >= 200112L;
или
cc -std=c99
ОПИСАНИЕ
Эти функции вычисляют обратный гиперболический тангенс значения
x;
гиперболический тангенс результата будет равен
x.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении данные функции возвращают обратный гиперболический
тангенс от
x.
Если x равно NaN, будет возвращено NaN.
Если x равно +0 (-0), будет возвращено +0 (-0).
Если x равно +1 или -1, то возникает ошибка особой точки, а функции
возвращают HUGE_VAL, HUGE_VALF или HUGE_VALL, соответственно, с
математически правильным знаком.
Если абсолютное значение x больше 1, то будет сгенерирована ошибка выхода
за пределы области, а в качестве результата будет возвращено NaN.
ОШИБКИ
Смотрите
math_error(7), чтобы определить, какие ошибки могут возникать
при вызове этих функций.
Могут возникать следующие ошибки:
Ошибка области:
x меньше -1 или больше +1
Значение
errno устанавливается в
EDOM. Вызывается исключение
неправильной плавающей точки (
FE_INVALID).
Ошибка особой точки:
x равно +1 или -1
Значение
errno устанавливается в
ERANGE (но смотрите
ДЕФЕКТЫ). Возникает исключение деления плавающей запятой на ноль
(
FE_DIVBYZERO).
АТРИБУТЫ
Описание терминов данного раздела смотрите в
attributes(7).
Интерфейс Атрибут Значение
atanh(),
atanhf(),
atanhl()
безвредность в потоках: безвредно (MT-Safe)
СООТВЕТСТВИЕ СТАНДАРТАМ
C99, POSIX.1-2001, POSIX.1-2008.
Вариант, возвращающий значение типа double, также соответствует SVr4,
4.3BSD, C89.
ДЕФЕКТЫ
В glibc 2.9 и ранее при возникновении ошибки особой точки, значению
errno
присваивается
EDOM вместо
ERANGE согласно POSIX. Начиная с версии
2.10, в glibc это исправлено.
