Namespaces
Variants

std:: arg (std::complex)

From cppreference.net
C++
Numerics library
std::complex
Défini dans l'en-tête <complex>
template < class T >
T           arg ( const std:: complex < T > & z ) ;
(1)
Défini dans l'en-tête <complex>
(A)
float arg ( float f ) ;

double arg ( double f ) ;

long double arg ( long double f ) ;
(jusqu'à C++23)
template < class FloatingPoint >

FloatingPoint

arg ( FloatingPoint f ) ;
(depuis C++23)
template < class Integer >
double arg ( Integer i ) ;
(B)
1) Calcule l'angle de phase (en radians) du nombre complexe z .
A,B) Des surcharges supplémentaires sont fournies pour tous les types entiers et à virgule flottante, qui sont traités comme des nombres complexes avec une composante imaginaire nulle.
(depuis C++11)

Table des matières

Paramètres

z - valeur complexe
f - valeur à virgule flottante
i - valeur entière

Valeur de retour

1) std:: atan2 ( std:: imag ( z ) , std:: real ( z ) ) . Si aucune erreur ne survient, ceci représente l'angle de phase de z dans l'intervalle [−π; π] .
A) Zéro si f est positif ou +0, π si f est négatif ou -0, NaN sinon.
B) Zéro si i est non négatif, π s'il est négatif.

Notes

Les surcharges supplémentaires ne sont pas tenues d'être fournies exactement comme (A,B) . Elles doivent seulement être suffisantes pour garantir que pour leur argument num :

  • Si num a un type standard (jusqu'à C++23) à virgule flottante T , alors std :: arg ( num ) a le même effet que std :: arg ( std:: complex < T > ( num ) ) .
  • Sinon, si num a un type entier, alors std :: arg ( num ) a le même effet que std :: arg ( std:: complex < double > ( num ) ) .

Exemple

Exécuter ce code 
#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';
}

Sortie : 

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

Voir aussi

renvoie la magnitude d'un nombre complexe
(modèle de fonction)
construit un nombre complexe à partir de la magnitude et de l'angle de phase
(modèle de fonction)
(C++11) (C++11)
arc tangente, utilisant les signes pour déterminer les quadrants
(fonction)
applique la fonction std::atan2 à un valarray et une valeur
(modèle de fonction)
Documentation C pour carg