Namespaces
Variants

cargf, carg, cargl

From cppreference.net
C
Numerics
Complex number arithmetic
Types and the imaginary constant
Manipulation
(C99)
(C99)
carg
(C99)
(C99)
(C99)
(C99)
Power and exponential functions
(C99)
(C99)
(C99)
(C99)
Trigonometric functions
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)
Hyperbolic functions
(C99)
(C99)
(C99)
(C99)
(C99)
(C99)
Défini dans l'en-tête <complex.h>
float cargf ( float complex z ) ;
(1) (depuis C99)
double carg ( double complex z ) ;
(2) (depuis C99)
long double cargl ( long double complex z ) ;
(3) (depuis C99)
Défini dans l'en-tête <tgmath.h>
#define carg( z )
(4) (depuis C99)
1-3) Calcule l'argument (également appelé angle de phase) de z , avec une coupure de branche le long de l'axe réel négatif.
4) Macro générique de type : si z a le type long double complex , long double imaginary , ou long double , cargl est appelé. Si z a le type float complex , float imaginary , ou float , cargf est appelé. Si z a le type double complex , double imaginary , double , ou tout type entier, carg est appelé.

Table des matières

Paramètres

z - argument complexe

Valeur de retour

Si aucune erreur ne se produit, retourne l'angle de phase de z dans l'intervalle [−π; π] .

Les erreurs et les cas particuliers sont gérés comme si la fonction était implémentée comme atan2 ( cimag ( z ) , creal ( z ) )

Exemple

Exécuter ce code 
#include <stdio.h>
#include <complex.h>
int main(void) 
{
    double complex z1 = 1.0+0.0*I;
    printf("phase angle of %.1f%+.1fi is %f\n", creal(z1), cimag(z1), carg(z1));
    double complex z2 = 0.0+1.0*I;
    printf("phase angle of %.1f%+.1fi is %f\n", creal(z2), cimag(z2), carg(z2));
    double complex z3 = -1.0+0.0*I;
    printf("phase angle of %.1f%+.1fi is %f\n", creal(z3), cimag(z3), carg(z3));
    double complex z4 = conj(z3); // or CMPLX(-1, -0.0)
    printf("phase angle of %.1f%+.1fi (the other side of the cut) is %f\n",
             creal(z4), cimag(z4), carg(z4));
}

Sortie : 

phase angle of 1.0+0.0i is 0.000000
phase angle of 0.0+1.0i is 1.570796
phase angle of -1.0+0.0i is 3.141593
phase angle of -1.0-0.0i (the other side of the cut) is -3.141593

Références

  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.3.9.1 Les fonctions carg (p: 196)
  • 7.25 Mathématiques génériques de type <tgmath.h> (p: 373-375)
  • G.7 Mathématiques génériques de type <tgmath.h> (p: 545)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.3.9.1 Les fonctions carg (p: 178)
  • 7.22 Mathématiques génériques de type <tgmath.h> (p: 335-337)
  • G.7 Mathématiques génériques de type <tgmath.h> (p: 480)

Voir aussi

(C99) (C99) (C99)
calcule le module d'un nombre complexe
(fonction)
(C99) (C99)
calcule l'arc tangente, en utilisant les signes pour déterminer les quadrants
(fonction)
Documentation C++ pour arg