命名空间
变体
操作

std::comp_ellint_2、std::comp_ellint_2f、std::comp_ellint_2l

来自 cppreference.com
 
 
 
 
定义在头文件 <cmath>
(1)
float       comp_ellint_2 ( float k );

double      comp_ellint_2 ( double k );

long double comp_ellint_2 ( long 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 起)
1-3) 计算 第二类完全椭圆积分k 库为所有 cv 无限定浮点类型提供 std::comp_ellint_2 的重载,作为参数 k 的类型。(自 C++23 起)
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),其中 Estd::comp_ellint_2。当偏心率等于 0 时,椭圆退化为半径为 a 的圆,周长等于 2πa,因此 E(0) = π/2。当偏心率等于 1 时,椭圆退化为长度为 2a 的直线,其周长为 4a,因此 E(1) = 1

其他重载不需要完全按 (A) 提供。它们只需要足够多,以确保对于其整数类型的参数 numstd::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 网页资源。