Namensräume
Varianten
Aktionen

std::laguerre, std::laguerref, std::laguerrel

Von cppreference.com
 
 
 
 
Definiert in der Header-Datei <cmath>
(1)
float       laguerre ( unsigned int n, float x );

double      laguerre ( unsigned int n, double x );

long double laguerre ( unsigned int n, long double x );
(seit C++17)
(bis C++23)
/* Gleitkommazahl-Typ */ laguerre( unsigned int n,
                                    /* Gleitkommazahl-Typ */ x );
(seit C++23)
float       laguerref( unsigned int n, float x );
(2) (seit C++17)
long double laguerrel( unsigned int n, long double x );
(3) (seit C++17)
Definiert in der Header-Datei <cmath>
template< class Integer >
double      laguerre ( unsigned int n, Integer x );
(A) (seit C++17)
1-3) Berechnet die nicht-assoziierten Laguerre-Polynome des Grades n und des Arguments x. Die Bibliothek stellt Überladungen von std::laguerre für alle cv-unqualifizierten Gleitkommatypen als Typ des Parameters x bereit.(seit C++23)
A) Zusätzliche Überladungen werden für alle ganzzahligen Typen bereitgestellt, die als double behandelt werden.

Inhalt

[edit] Parameter

n - der Grad des Polynoms, ein vorzeichenloser Ganzzahlwert
x - das Argument, ein Gleitkomma- oder Ganzzahlwert

[edit] Rückgabewert

Wenn keine Fehler auftreten, wird der Wert des nicht-assoziierten Laguerre-Polynoms von x zurückgegeben, d. h.
ex
n!
dn
dxn
(xn
e-x)
.

[edit] Fehlerbehandlung

Fehler können wie in math_errhandling angegeben gemeldet werden.

  • Wenn das Argument NaN ist, wird NaN zurückgegeben und kein Domänenfehler gemeldet.
  • Wenn x negativ ist, kann ein Domänenfehler auftreten.
  • Wenn n größer oder gleich 128 ist, ist das Verhalten implementierungsabhängig.

[edit] Anmerkungen

Implementierungen, die C++17 nicht unterstützen, aber ISO 29124:2010 unterstützen, stellen diese Funktion bereit, wenn __STDCPP_MATH_SPEC_FUNCS__ von der Implementierung auf einen Wert von mindestens 201003L definiert wird und wenn der Benutzer __STDCPP_WANT_MATH_SPEC_FUNCS__ definiert, bevor er beliebige Standardbibliotheks-Header einschließt.

Implementierungen, die ISO 29124:2010 nicht unterstützen, aber TR 19768:2007 (TR1) unterstützen, stellen diese Funktion im Header tr1/cmath im Namespace std::tr1 bereit.

Eine Implementierung dieser Funktion ist auch in boost.math verfügbar.

Die Laguerre-Polynome sind die Polynomlösungen der Gleichung .

Die ersten paar sind

Function Polynom
    laguerre(0, x)     1
laguerre(1, x) -x + 1
laguerre(2, x)
1
2
(x2
- 4x + 2)
laguerre(3, x)     
1
6
(-x3
- 9x2
- 18x + 6)
    

Die zusätzlichen Überladungen müssen nicht genau wie in (A) bereitgestellt werden. Sie müssen nur ausreichen, um sicherzustellen, dass für ihr Argument num vom Ganzzahltyp, std::laguerre(int_num, num) denselben Effekt hat wie std::laguerre(int_num, static_cast<double>(num)).

[edit] Beispiel

#include <cmath>
#include <iostream>
 
double L1(double x)
{
    return -x + 1;
}
 
double L2(double x)
{
    return 0.5 * (x * x - 4 * x + 2);
}
 
int main()
{
    // spot-checks
    std::cout << std::laguerre(1, 0.5) << '=' << L1(0.5) << '\n'
              << std::laguerre(2, 0.5) << '=' << L2(0.5) << '\n'
              << std::laguerre(3, 0.0) << '=' << 1.0 << '\n';
}

Ausgabe

0.5=0.5
0.125=0.125
1=1

[edit] Siehe auch

assoziierte Laguerre-Polynome
(Funktion) [bearbeiten]

[edit] Externe Links

Weisstein, Eric W. "Laguerre Polynomial." Von MathWorld – Eine Wolfram Web Ressource.