ИМЯ

       atanh, atanhf, atanhl - вычисление функции обратного гиперболического тангенса

LIBRARY

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

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

       Ошибка области: 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.

ДЕФЕКТЫ

       In  glibc  2.9  and earlier, when a pole error occurs, errno is set to EDOM instead of the POSIX-mandated
       ERANGE.  Since glibc 2.10, glibc does the right thing.

СМ. ТАКЖЕ

       acosh(3), asinh(3), catanh(3), cosh(3), sinh(3), tanh(3)

ПЕРЕВОД

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

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если  вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                            5 февраля 2023 г.                                       atanh(3)