Asinh

定义于头文件 <cmath> 中。

描述

计算 num 的反双曲正弦。 ​ 该库为所有 cv 非限定浮点类型提供了 std::asinh 的重载，作为参数 num 的类型  (自 C++23 起)。
​额外重载为所有整数类型提供，它们被视为 double。

声明

C++23

// 1)
/* floating-point-type */ asinh( /* floating-point-type */ num );
// 2)
float asinhf( float num );
// 3)
long double asinhl( long double num );

附加重载

// 4)
template< class Integer >
double asinh ( Integer num );

C++11

//1 )
float asinh ( float num );
// 2)
double asinh ( double num );
// 3)
long double asinh ( long double num );
// 4)
float asinhf( float num );
// 5)
long double asinhl( long double num );

附加重载

// 6)
template< class Integer >
double asinh ( Integer num );

参数

num - 浮点或整数值

返回值

如果没有错误发生，则返回 num 的反双曲正弦 (sinh^-1(num)，或 arsinh(num))。

如果因下溢导致范围错误，则返回正确结果（舍入后）。

错误处理

错误按 math_errhandling 中指定的方式报告。

如果实现支持 IEEE 浮点运算（IEC 60559）

如果参数是 ±0 或 ±∞，则返回未修改的值；如果参数是 NaN，则返回 NaN。

备注

尽管 C 标准（C++ 在此函数中引用该标准）将此函数命名为“反双曲正弦”，但双曲函数的反函数是面积函数。它们的参数是双曲扇形的面积，而不是弧。正确的名称是“反双曲正弦”（POSIX 使用）或“面积双曲正弦”。

额外重载不要求完全按照额外重载提供。它们只需要足以确保对于整数类型的参数 num，std::asinh(num) 的效果与 std::asinh(static_cast<double>(num)) 相同。

示例

#include <cmath>
#include <iostream>
 
int main()
{
    std::cout 
        << "asinh(1) = " 
        << std::asinh(1) << '\n'
        << "asinh(-1) = " 
        << std::asinh(-1) << '\n';
 
    // special values
    std::cout 
        << "asinh(+0) = " 
        << std::asinh(+0.0) << '\n'
        << "asinh(-0) = " 
        <<  std::asinh(-0.0) << '\n';
}

结果

asinh(1) = 0.881374
asinh(-1) = -0.881374
asinh(+0) = 0
asinh(-0) = -0