std::asinh, std::asinhf, std::asinhl

在头文件 `<cmath>` 中定义
	(1)
float asinh ( float num ); double asinh ( double num ); long double asinh ( long double num );			(直到 C++23)
/* 浮点类型 / asinh ( / 浮点类型 */ num );			(自 C++23 起) (自 C++26 起为 constexpr)
float asinhf( float num );		(2)	(自 C++11 起) (自 C++26 起为 constexpr)
long double asinhl( long double num );		(3)	(自 C++11 起) (自 C++26 起为 constexpr)
附加重载 (自 C++11 起)
在头文件 `<cmath>` 中定义
template< class Integer > double asinh ( Integer num );		(A)	(自 C++26 起为 constexpr)

1-3) 计算 num 的反双曲正弦。库为所有 cv 无限定浮点类型提供了 std::asinh 的重载，作为参数的类型。(自 C++23 起)

A) 为所有整数类型提供额外的重载，这些类型被视为 double。

(自 C++11 起)

[编辑] 参数

num

-

浮点或整数值

[编辑] 返回值

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

如果由于下溢而发生范围错误，则返回正确的结果（舍入后）。

[编辑] 错误处理

错误的报告方式如 math_errhandling 中所述。

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

如果参数为 ±0 或 ±∞，则将其未经修改地返回。
如果参数为 NaN，则返回 NaN。

[编辑] 注释

尽管 C 标准（C++ 针对该函数的引用来源）将该函数命名为“反双曲正弦”，但双曲函数的反函数是面积函数。它们的论证是双曲扇形的面积，而不是弧长。正确的名称是“反双曲正弦”（POSIX 使用）或“面积双曲正弦”。

附加重载不需要完全按照 (A) 提供。它们只需要足够确保对于其整数类型的参数 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

[编辑] 另请参阅

acoshacoshfacoshl (C++11)(C++11)(C++11)	计算反双曲余弦 (${\small\operatorname{arcosh}{x}}$ $arcosh(x)$ ) (函数) [编辑]
atanhatanhfatanhl (C++11)(C++11)(C++11)	计算反双曲正切 (${\small\operatorname{artanh}{x}}$ $artanh(x)$ ) (函数) [编辑]
sinhsinhfsinhl (C++11)(C++11)	计算双曲正弦 (${\small\sinh{x}}$ $sinh(x)$ ) (函数) [编辑]
asinh(std::complex) (C++11)	计算复数的面积双曲正弦 (${\small\operatorname{arsinh}{z}}$ $arsinh(z)$ ) (函数模板) [编辑]
C 文档 for asinh

[编辑] 外部链接

Weisstein, Eric W. "反双曲正弦." 来自 Wolfram Web 资源 — MathWorld.

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作