std::ellint_3, std::ellint_3f, std::ellint_3l

Определено в заголовочном файле `<cmath>`
	(1)
float ellint_3 ( float k, float nu, float phi ); double ellint_3 ( double k, double nu, double phi ); long double ellint_3 ( long double k, long double nu, long double phi );		(с C++17) (до C++23)
/* floating-point-type / ellint_3( / floating-point-type / k, / floating-point-type / nu, / floating-point-type */ phi );		(с C++23)
float ellint_3f( float k, float nu, float phi );	(2)	(с C++17)
long double ellint_3l( long double k, long double nu, long double phi );	(3)	(с C++17)
Дополнительные перегрузки
Определено в заголовочном файле `<cmath>`
template< class Arithmetic1, class Arithmetic2, class Arithmetic3 > /* common-floating-point-type */ ellint_3( Arithmetic1 k, Arithmetic2 nu, Arithmetic3 phi );	(A)	(с C++17)

1-3) Вычисляет неполный эллиптический интеграл третьего рода от k, nu, и phi. Библиотека предоставляет перегрузки std::ellint_3 для всех типов чисел с плавающей точкой без квалификаторов cv в качестве типа параметров k, nu и phi.(с C++23)

A) Дополнительные перегрузки предоставляются для всех других комбинаций типов арифметических типов.

Параметры

k	-	эллиптический модуль или эксцентриситет (значение с плавающей точкой или целое число)
nu	-	эллиптическая характеристика (значение с плавающей точкой или целое число)
phi	-	амплитуда Якоби (значение с плавающей точкой или целое число, измеряемое в радианах)

Возвращаемое значение

Если ошибки не возникло, возвращается значение неполного эллиптического интеграла третьего рода от k, nu, и phi, то есть ∫_phi0dθ/(1-nusin2θ)√1-k2sin2θ.

Обработка ошибок

Ошибки могут быть сообщены, как указано в 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 и третьего аргумента num3:

Если num1, num2 или num3 имеет тип long double, то std::ellint_3(num1, num2, num3) имеет тот же эффект, что и std::ellint_3(static_cast<long double>(num1), static_cast<long double>(num2), static_cast<long double>(num3)).
В противном случае, если num1, num2 и/или num3 имеет тип double или целочисленный тип, то std::ellint_3(num1, num2, num3) имеет тот же эффект, что и std::ellint_3(static_cast<double>(num1), static_cast<double>(num2), static_cast<double>(num3)).
В противном случае, если num1, num2 или num3 имеет тип float, то std::ellint_3(num1, num2, num3) имеет тот же эффект, что и std::ellint_3(static_cast<float>(num1), static_cast<float>(num2), static_cast<float>(num3)).

(до C++23)

Если num1, num2 и num3 имеют арифметические типы, то std::ellint_3(num1, num2, num3) имеет тот же эффект, что и std::ellint_3(static_cast</* common-floating-point-type */>(num1), static_cast</* common-floating-point-type */>(num2), static_cast</* common-floating-point-type */>(num3)), где /* common-floating-point-type */ — это тип с плавающей точкой с наибольшим рангом преобразования с плавающей точкой и наибольшим подрангом преобразования с плавающей точкой среди типов num1, num2 и num3. Аргументы целого типа считаются имеющими тот же ранг преобразования с плавающей точкой, что и double.

Если такого типа с плавающей точкой с наибольшим рангом и подрангом не существует, то разрешение перегрузки не приводит к кандидату из предоставленных перегрузок.

(с C++23)

Пример

#include <cmath>
#include <iostream>
#include <numbers>
 
int main()
{
    const double hpi = std::numbers::pi / 2;
 
    std::cout << "Π(0,0,π/2) = " << std::ellint_3(0, 0, hpi) << '\n'
              << "π/2 = " << hpi << '\n';
}

Вывод:

Π(0,0,π/2) = 1.5708
π/2 = 1.5708

См. также

comp_ellint_3comp_ellint_3fcomp_ellint_3l

(C++17)(C++17)(C++17)

(полный) эллиптический интеграл третьего рода
(функция)

Внешние ссылки

Weisstein, Eric W. "Elliptic Integral of the Third Kind." From MathWorld — A Wolfram Web Resource.

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/special_functions/ellint_3