std::acosh(std::complex)
来自 cppreference.cn
定义于头文件 <complex> |
||
template< class T > complex<T> acosh( const complex<T>& z ); |
(自 C++11 起) | |
计算复数值 z 的复反双曲余弦,其分支切割线位于实轴上小于 1 的值。
目录 |
[编辑] 参数
z | - | 复数值 |
[编辑] 返回值
如果没有错误发生,则返回 z 的复反双曲余弦值,其范围为实轴上的非负值半带,以及虚轴上 [−iπ; +iπ] 区间。
[编辑] 错误处理和特殊值
错误的报告与 math_errhandling 一致。
如果实现支持 IEEE 浮点算术,
- std::acosh(std::conj(z)) == std::conj(std::acosh(z)).
- 如果 z 为
(±0,+0)
,则结果为(+0,π/2)
。 - 如果 z 为
(x,+∞)
(对于任何有限 x),则结果为(+∞,π/2)
。 - 如果 z 为
(x,NaN)
(对于任何[1] 有限 x),则结果为(NaN,NaN)
且可能引发 FE_INVALID。 - 如果 z 为
(-∞,y)
(对于任何正有限 y),则结果为(+∞,π)
。 - 如果 z 为
(+∞,y)
(对于任何正有限 y),则结果为(+∞,+0)
。 - 如果 z 为
(-∞,+∞)
,则结果为(+∞,3π/4)
。 - 如果 z 为
(±∞,NaN)
,则结果为(+∞,NaN)
。 - 如果 z 为
(NaN,y)
(对于任何有限 y),则结果为(NaN,NaN)
且可能引发 FE_INVALID。 - 如果 z 为
(NaN,+∞)
,则结果为(+∞,NaN)
。 - 如果 z 为
(NaN,NaN)
,则结果为(NaN,NaN)
。
[编辑] 注解
虽然 C++ 标准将此函数命名为 “complex arc hyperbolic cosine”(复反双曲余弦),但双曲函数的反函数是面积函数。它们的自变量是双曲扇形的面积,而不是弧长。正确的名称是 “complex inverse hyperbolic cosine”(复反双曲余弦),以及较不常见的 “complex area hyperbolic cosine”(复面积双曲余弦)。
反双曲余弦是多值函数,需要在复平面上进行分支切割。分支切割线通常放置在实轴的线段 (-∞,+1) 上。
反双曲余弦主值的数学定义为 acosh z = ln(z + √z+1 √z-1)。
对于任何 z,acosh(z) =√z-1 |
√1-z |
[编辑] 示例
运行此代码
#include <complex> #include <iostream> int main() { std::cout << std::fixed; std::complex<double> z1(0.5, 0); std::cout << "acosh" << z1 << " = " << std::acosh(z1) << '\n'; std::complex<double> z2(0.5, -0.0); std::cout << "acosh" << z2 << " (the other side of the cut) = " << std::acosh(z2) << '\n'; // in upper half-plane, acosh = i acos std::complex<double> z3(1, 1), i(0, 1); std::cout << "acosh" << z3 << " = " << std::acosh(z3) << '\n' << "i*acos" << z3 << " = " << i*std::acos(z3) << '\n'; }
输出
acosh(0.500000,0.000000) = (0.000000,-1.047198) acosh(0.500000,-0.000000) (the other side of the cut) = (0.000000,1.047198) acosh(1.000000,1.000000) = (1.061275,0.904557) i*acos(1.000000,1.000000) = (1.061275,0.904557)
[编辑] 参见
(C++11) |
计算复数的反余弦 (arccos(z)) (函数模板) |
(C++11) |
计算复数的反双曲正弦 (arsinh(z)) (函数模板) |
(C++11) |
计算复数的反双曲正切 (artanh(z)) (函数模板) |
计算复数的双曲余弦 (cosh(z)) (函数模板) | |
(C++11)(C++11)(C++11) |
计算反双曲余弦 (arcosh(x)) (函数) |
C 文档 关于 cacosh
|