Namespaces
Variants

cargf, carg, cargl

From cppreference.net
Definido en el encabezado <complex.h>
float cargf ( float complex z ) ;
(1) (desde C99)
double carg ( double complex z ) ;
(2) (desde C99)
long double cargl ( long double complex z ) ;
(3) (desde C99)
Definido en el encabezado <tgmath.h>
#define carg( z )
(4) (desde C99)
1-3) Calcula el argumento (también llamado ángulo de fase) de z , con un corte de rama a lo largo del eje real negativo.
4) Macro genérico de tipos: si z tiene tipo long double complex , long double imaginary , o long double , cargl es llamada. Si z tiene tipo float complex , float imaginary , o float , cargf es llamada. Si z tiene tipo double complex , double imaginary , double , o cualquier tipo entero, carg es llamada.

Contenidos

Parámetros

z - argumento complejo

Valor de retorno

Si no ocurren errores, retorna el ángulo de fase de z en el intervalo [−π; π] .

Los errores y casos especiales se manejan como si la función estuviera implementada como atan2 ( cimag ( z ) , creal ( z ) )

Ejemplo

#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));
}

Salida:

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

Referencias

  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.3.9.1 Las funciones carg (p: 196)
  • 7.25 Matemáticas genéricas de tipos <tgmath.h> (p: 373-375)
  • G.7 Matemáticas genéricas de tipos <tgmath.h> (p: 545)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.3.9.1 Las funciones carg (p: 178)
  • 7.22 Matemáticas genéricas de tipos <tgmath.h> (p: 335-337)
  • G.7 Matemáticas genéricas de tipos <tgmath.h> (p: 480)

Véase también

(C99) (C99) (C99)
calcula la magnitud de un número complejo
(función)
calcula el arcotangente, usando signos para determinar cuadrantes
(función)