std::comp_ellint_2、std::comp_ellint_2f、std::comp_ellint_2l
来自 cppreference.com
< cpp | numeric | special functions
定义在头文件 <cmath> 中 |
||
(1) | ||
float comp_ellint_2 ( float k ); double comp_ellint_2 ( double k ); |
(自 C++17 起) (直到 C++23) |
|
/* 浮点类型 */ comp_ellint_2( /* 浮点类型 */ k ); |
(自 C++23 起) | |
float comp_ellint_2f( float k ); |
(2) | (自 C++17 起) |
long double comp_ellint_2l( long double k ); |
(3) | (自 C++17 起) |
定义在头文件 <cmath> 中 |
||
template< class Integer > double comp_ellint_2 ( Integer k ); |
(A) | (自 C++17 起) |
A) 为所有整数类型提供其他重载,这些类型被视为 double。
内容 |
[编辑] 参数
k | - | 椭圆模量或偏心率(浮点或整数值) |
[编辑] 返回值
如果未发生错误,则返回 k 的第二类完全椭圆积分的值,即 std::ellint_2(k, π/2)。
[编辑] 错误处理
错误可能按 math_errhandling 中指定的方式报告。
- 如果参数为 NaN,则返回 NaN 且不报告域错误。
- 如果 |k|>1,则可能发生域错误。
[编辑] 注释
不支持 C++17 但支持 ISO 29124:2010 的实现,如果 __STDCPP_MATH_SPEC_FUNCS__
由实现定义为至少为 201003L 的值,并且如果用户在包含任何标准库头文件之前定义了 __STDCPP_WANT_MATH_SPEC_FUNCS__
,则提供此函数。
不支持 ISO 29124:2010 但支持 TR 19768:2007(TR1)的实现,在头文件 tr1/cmath
和命名空间 std::tr1
中提供此函数。
此函数的实现也 在 boost.math 中可用。
偏心率为 k 且长半轴为 a 的椭圆的周长等于 4aE(k),其中 E 是 std::comp_ellint_2
。当偏心率等于 0 时,椭圆退化为半径为 a 的圆,周长等于 2πa,因此 E(0) = π/2。当偏心率等于 1 时,椭圆退化为长度为 2a 的直线,其周长为 4a,因此 E(1) = 1。
其他重载不需要完全按 (A) 提供。它们只需要足够多,以确保对于其整数类型的参数 num,std::comp_ellint_2(num) 与 std::comp_ellint_2(static_cast<double>(num)) 具有相同的效果。
[编辑] 示例
运行此代码
#include <cmath> #include <iostream> #include <numbers> int main() { constexpr double hpi = std::numbers::pi / 2.0; std::cout << "E(0) = " << std::comp_ellint_2(0) << '\n' << "π/2 = " << hpi << '\n' << "E(1) = " << std::comp_ellint_2(1) << '\n' << "E(1, π/2) = " << std::ellint_2(1, hpi) << '\n'; }
输出
E(0) = 1.5708 π/2 = 1.5708 E(1) = 1 E(1, π/2) = 1
[编辑] 另请参见
(C++17)(C++17)(C++17) |
(不完全) 第二类椭圆积分 (函数) |
[编辑] 外部链接
Weisstein, Eric W. "第二类完全椭圆积分。" 来自 MathWorld - Wolfram 网页资源。 |