Scroll to navigation

ATANH(3) Руководство программиста Linux ATANH(3)

ИМЯ

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
    это
    исправлено.






СМ. ТАКЖЕ


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






ЗАМЕЧАНИЯ


Эта
    страница
    является
    частью
    проекта Linux
    man-pages версии 5.10.
    Описание
    проекта,
    информацию
    об ошибках
    и
    последнюю
    версию
    этой
    страницы
    можно
    найти по
    адресу
    https://www.kernel.org/doc/man-pages/.






ПЕРЕВОД


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


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


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







  

    15
      сентября 2017
      г.