std::acosh, std::acoshf, std::acoshl

float       acosh ( float num );
double      acosh ( double num );
long double acosh ( long double num );

/*floating-point-type*/
            acosh ( /*floating-point-type*/ num );

float       acoshf( float num );

long double acoshl( long double num );

template< /*math-floating-point*/ V >
constexpr /*deduced-simd-t*/<V> 
            acosh ( const V& v_num );

template< class Integer >
double      acosh ( Integer num );

Параметры

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

Если ошибок не возникает, возвращается обратный гиперболический косинус от num (cosh^-1(num), или arcosh(num)) на интервале [0, +∞].

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

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

Об ошибках сообщается согласно спецификации math_errhandling.

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

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

• если аргумент меньше 1, генерируется FE_INVALID и возвращается NaN.
• если аргумент равен 1, возвращается +0.
• если аргумент равен +∞, возвращается +∞.
• если аргумент равен NaN, возвращается NaN.

Примечания

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

Дополнительные перегрузки не обязаны предоставляться в точности в виде (A). Они должны лишь обеспечивать, чтобы для аргумента num целочисленного типа std::acosh(num) имело тот же эффект, что и std::acosh(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 << "acosh(1) = " << std::acosh(1) << '\n'
              << "acosh(10) = " << std::acosh(10) << '\n'
              << "acosh(DBL_MAX) = " << std::acosh(DBL_MAX) << '\n'
              << "acosh(Inf) = " << std::acosh(INFINITY) << '\n';
    
    // error handling
    errno = 0;
    std::feclearexcept(FE_ALL_EXCEPT);
    
    std::cout << "acosh(0.5) = " << std::acosh(0.5) << '\n';
    
    if (errno == EDOM)
        std::cout << "    errno == EDOM: " << std::strerror(errno) << '\n';
    if (std::fetestexcept(FE_INVALID))
        std::cout << "    FE_INVALID raised\n";
}

acosh(1) = 0
acosh(10) = 2.99322
acosh(DBL_MAX) = 710.476
acosh(Inf) = inf
acosh(0.5) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised

См. также

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