ИМЯ

atanh, 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():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 500 || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE || /* версии glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

atanhf(), atanhl():

_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE || /* версии glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

ОПИСАНИЕ

Эти функции вычисляют обратный гиперболический тангенс значения 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.

ДЕФЕКТЫ

В glibc 2.9 и ранее при возникновении ошибки особой точки, значению errno присваивается EDOM вместо ERANGE согласно POSIX. Начиная с версии 2.10, в glibc это исправлено.

ИМЯ