ИМЯ

       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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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