Namespaces
Variants

std:: ellint_2, std:: ellint_2f, std:: ellint_2l

From cppreference.net
C++
Numerics library
Mathematical special functions
ヘッダーで定義 <cmath>
(1)
float ellint_2 ( float k, float phi ) ;

double ellint_2 ( double k, double phi ) ;

long double ellint_2 ( long double k, long double phi ) ;
(C++17以降)
(C++23まで)
/* floating-point-type */ ellint_2 ( /* floating-point-type */ k,
/* floating-point-type */ phi ) ;
(C++23以降)
float ellint_2f ( float k, float phi ) ;
(2) (C++17以降)
long double ellint_2l ( long double k, long double phi ) ;
(3) (C++17以降)
ヘッダーで定義 <cmath>
template < class Arithmetic1, class Arithmetic2 >

/* common-floating-point-type */

ellint_2 ( Arithmetic1 k, Arithmetic2 phi ) ;
(A) (C++17以降)
1-3) 第2種 不完全楕円積分 を k と phi に対して計算する。 ライブラリは、パラメータ k および phi の型として、すべてのcv修飾されていない浮動小数点型に対する std::ellint_2 のオーバーロードを提供する。 (C++23以降)
A) その他の算術型のすべての組み合わせに対して、追加のオーバーロードが提供されています。

目次

パラメータ

k - 楕円率または離心率（浮動小数点数または整数値）
phi - ヤコビ振幅（浮動小数点数または整数値、ラジアン単位で測定）

戻り値

エラーが発生しない場合、第二種不完全楕円積分の値、 k および phi の、すなわち ∫ phi
0 √ 1-k 2
sin 2
θ dθ が返されます。

エラーハンドリング

エラーは以下のように報告される場合があります 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 でも利用可能です。

追加のオーバーロードは (A) と完全に同一である必要はありません。これらは、第一引数 num1 と第二引数 num2 について以下を保証するのに十分であればよいのです：

  • num1 または num2 の型が long double の場合、 std :: ellint2 ( num1, num2 ) は std :: ellint2 ( static_cast < long double > ( num1 ) ,
    static_cast < long double > ( num2 ) )     と同じ効果を持つ。
  • それ以外の場合、 num1 および/または num2 の型が double または整数型の場合、 std :: ellint2 ( num1, num2 ) は std :: ellint2 ( static_cast < double > ( num1 ) ,
    static_cast < double > ( num2 ) )     と同じ効果を持つ。
  • それ以外の場合、 num1 または num2 の型が float の場合、 std :: ellint2 ( num1, num2 ) は std :: ellint2 ( static_cast < float > ( num1 ) ,
    static_cast < float > ( num2 ) )     と同じ効果を持つ。
(C++23まで)

num1 と num2 が算術型を持つ場合、 std :: ellint2 ( num1, num2 ) は std :: ellint2 ( static_cast < /* common-floating-point-type */ > ( num1 ) ,
static_cast < /* common-floating-point-type */ > ( num2 ) ) と同じ効果を持つ。ここで /* common-floating-point-type */ は num1 と num2 の型の間で最も高い 浮動小数点変換ランク と最も高い 浮動小数点変換サブランク を持つ浮動小数点型であり、整数型の引数は double と同じ浮動小数点変換ランクを持つと見なされる。

最も高いランクとサブランクを持つ浮動小数点型が存在しない場合、 オーバーロード解決 は提供されたオーバーロードから使用可能な候補を結果として生成しない。

(C++23以降)

例

このコードを実行 
#include <cmath>
#include <iostream>
#include <numbers>
int main()
{
    const double hpi = std::numbers::pi / 2.0;
    std::cout << "E(0,π/2)  = " << std::ellint_2(0, hpi) << '\n'
              << "E(0,-π/2) = " << std::ellint_2(0, -hpi) << '\n'
              << "π/2       = " << hpi << '\n'
              << "E(0.7,0)  = " << std::ellint_2(0.7, 0) << '\n'
              << "E(1,π/2)  = " << std::ellint_2(1, hpi) << '\n';
}

出力: 

E(0,π/2)  = 1.5708
E(0,-π/2) = -1.5708
π/2       = 1.5708
E(0.7,0)  = 0
E(1,π/2)  = 1

関連項目

(C++17) (C++17) (C++17)
第二種完全楕円積分
(関数)

外部リンク

Weisstein, Eric W. "Elliptic Integral of the Second Kind." From MathWorld — A Wolfram Web Resource.
Weisstein, Eric W. "第二種楕円積分" MathWorld — Wolfram Web リソースより