Other Alias
atanh, 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.