atanh(3)

НАИМЕНОВАНИЕ
atanh, atanhf, atanhl - вычисление функции обратного гиперболического тангенса

БИБЛИОТЕКА
Математическая библиотека (libm, -lm)

СИНТАКСИС
#include <math.h>

double atanh(double x);
float atanhf(float x);
long double atanhl(long double x);

    Требования макроса тестирования свойств для 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), чтобы определить, какие ошибки могут возникать при вызове этих функций.

Могут возникать следующие ошибки:

Domain error: x less than -1 or greater than +1
    errno устанавливается в EDOM. Вызывается исключение неправильной плавающей точки (FE_INVALID).

Pole error: x is +1 or -1
    errno устанавливается в ERANGE (но смотрите ДЕФЕКТЫ). Возникает исключение деления плавающей запятой на ноль (FE_DIVBYZERO).

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
atanh(), atanhf(), atanhl() | Безвредность в нитях | MT-Safe

СТАНДАРТЫ
C11, POSIX.1-2008.

ИСТОРИЯ
C99, POSIX.1-2001.

Вариант, возвращающий значение типа double, также соответствует SVr4, 4.3BSD.

ПРОГРАММНЫЕ ОШИБКИ
В glibc 2.9 и более ранних версиях при возникновении ошибки полюса errno устанавливается в EDOM вместо предписанного POSIX ERANGE. Начиная с glibc 2.10, glibc делает все правильно.

СМОТРИТЕ ТАКЖЕ
acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) Dmitry Bolkhovskikh <d20052005@yandex.ru> и Yuri Kozlov <yuray@komyakino.ru>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (debian-l10n-russian@lists.debian.org).