std:: atanh, std:: atanhf, std:: atanhl

Параметры

Возвращаемое значение

Если ошибок не возникает, возвращается обратный гиперболический тангенс num ( tanh -1
(num) , или artanh(num) ).

Если происходит ошибка области определения, возвращается значение, определяемое реализацией (NaN, если поддерживается).

Если возникает ошибка полюса, ±HUGE_VAL , ±HUGE_VALF , или ±HUGE_VALL возвращается (с правильным знаком).

Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат (после округления).

Обработка ошибок

Ошибки сообщаются, как указано в math_errhandling .

Если аргумент не находится на интервале [ - 1 , + 1 ] , возникает ошибка диапазона.

Если аргумент равен ±1, возникает ошибка полюса.

Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),

• если аргумент равен ±0, он возвращается без изменений.
• если аргумент равен ±1, возвращается ±∞ и FE_DIVBYZERO устанавливается.
• если |num|>1 , возвращается NaN и FE_INVALID устанавливается.
• если аргумент равен NaN, возвращается NaN.

Примечания

Хотя стандарт C (на который ссылается C++ для этой функции) называет эту функцию «аркгиперболический тангенс», обратные функции гиперболических функций являются ареа-функциями. Их аргумент представляет собой площадь гиперболического сектора, а не дугу. Правильное название — «обратный гиперболический тангенс» (используется в POSIX) или «ареа-гиперболический тангенс».

POSIX определяет , что в случае потери значимости (underflow), num возвращается без изменений, и если это не поддерживается, возвращается определяемое реализацией значение, не превышающее DBL_MIN , FLT_MIN и LDBL_MIN .

Дополнительные перегрузки не обязаны быть предоставлены в точности как (A) . Они лишь должны быть достаточными для обеспечения того, чтобы для их аргумента num целочисленного типа, std :: atanh ( num ) имел тот же эффект, что и std :: atanh ( static_cast < double > ( num ) ) .

Пример

#include <cerrno>
#include <cfenv>
#include <cfloat>
#include <cmath>
#include <cstring>
#include <iostream>
// #pragma STDC FENV_ACCESS ON
int main()
{
    std::cout << "atanh(0) = " << std::atanh(0) << '\n'
              << "atanh(-0) = " << std::atanh(-0.0) << '\n'
              << "atanh(0.9) = " << std::atanh(0.9) << '\n';
    // обработка ошибок
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    std::cout << "atanh(-1) = " << std::atanh(-1) << '\n';
    if (errno == ERANGE)
        std::cout << "    errno == ERANGE: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_DIVBYZERO))
        std::cout << "    FE_DIVBYZERO raised\n";
}

atanh(0) = 0
atanh(-0) = -0
atanh(0.9) = 1.47222
atanh(-1) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

Смотрите также

Внешние ссылки