Namespaces
Variants

std:: arg (std::complex)

From cppreference.net
C++
Numerics library
std::complex
Definiert im Header <complex>
template < class T >
T           arg ( const std:: complex < T > & z ) ;
(1)
Definiert im Header <complex>
(A)
float arg ( float f ) ;

double arg ( double f ) ;

long double arg ( long double f ) ;
(bis C++23)
template < class FloatingPoint >

FloatingPoint

arg ( FloatingPoint f ) ;
(seit C++23)
template < class Integer >
double arg ( Integer i ) ;
(B)
1) Berechnet den Phasenwinkel (in Radiant) der komplexen Zahl z .
A,B) Zusätzliche Überladungen werden für alle Ganzzahl- und Gleitkommatypen bereitgestellt, die als komplexe Zahlen mit null Imaginärteil behandelt werden.
(since C++11)

Inhaltsverzeichnis

Parameter

z - komplexer Wert
f - Fließkommawert
i - Ganzzahlwert

Rückgabewert

1) std:: atan2 ( std:: imag ( z ) , std:: real ( z ) ) . Wenn keine Fehler auftreten, ist dies der Phasenwinkel von z im Intervall [−π; π] .
A) Null, falls f positiv oder +0 ist, π falls f negativ oder -0 ist, andernfalls NaN.
B) Null, falls i nicht-negativ ist, π falls negativ.

Hinweise

Die zusätzlichen Überladungen müssen nicht exakt als (A,B) bereitgestellt werden. Sie müssen lediglich ausreichend sein, um sicherzustellen, dass für ihr Argument num :

  • Wenn num einen Standard (bis C++23) Gleitkommatyp T hat, dann hat std :: arg ( num ) denselben Effekt wie std :: arg ( std:: complex < T > ( num ) ) .
  • Andernfalls, wenn num einen Ganzzahltyp hat, dann hat std :: arg ( num ) denselben Effekt wie std :: arg ( std:: complex < double > ( num ) ) .

Beispiel

Diesen Code ausführen 
#include <complex>
#include <iostream>
int main() 
{
    std::complex<double> z1(1, 0);
    std::complex<double> z2(0, 0);
    std::complex<double> z3(0, 1);
    std::complex<double> z4(-1, 0);
    std::complex<double> z5(-1, -0.0);
    double f = 1.;
    int i = -1;
    std::cout << "phase angle of " << z1 << " is " << std::arg(z1) << '\n'
              << "phase angle of " << z2 << " is " << std::arg(z2) << '\n'
              << "phase angle of " << z3 << " is " << std::arg(z3) << '\n'
              << "phase angle of " << z4 << " is " << std::arg(z4) << '\n'
              << "phase angle of " << z5 << " is " << std::arg(z5) << " "
                 "(the other side of the cut)\n"
              << "phase angle of " << f << " is " << std::arg(f) << '\n'
              << "phase angle of " << i << " is " << std::arg(i) << '\n';
}

Ausgabe: 

phase angle of (1,0) is 0
phase angle of (0,0) is 0
phase angle of (0,1) is 1.5708
phase angle of (-1,0) is 3.14159
phase angle of (-1,-0) is -3.14159 (the other side of the cut)
phase angle of 1 is 0
phase angle of -1 is 3.14159

Siehe auch

gibt den Betrag einer komplexen Zahl zurück
(Funktions-Template)
erstellt eine komplexe Zahl aus Betrag und Phasenwinkel
(Funktions-Template)
(C++11) (C++11)
Arcustangens unter Verwendung von Vorzeichen zur Quadrantenbestimmung
(Funktion)
wendet die Funktion std::atan2 auf ein valarray und einen Wert an
(Funktions-Template)
C-Dokumentation für carg