cargf Function

Calculates the argument of a single precision complex value.

Attention: This function is implemented only by MPLAB XC32 C compilers.

Include

<complex.h>

Prototype

float complex cargf(float complex z);

Argument

`z`	value for which to return the argument

Return Value

Returns the argument (or phase angle) of z in the interval [-π, +π] and with a branch cut along the negative real axis.

Example

See the notes at the beginning of this chapter or section for information on using printf() or scanf() (and other functions reading and writing the stdin or stdout streams) in the example code.

#include <stdio.h>
#include <complex.h>

int main(void)
{
  float complex x, y;

  x = -2.0 + 1.0*I;
  y = cargf(x);
  printf("The complex argument of %f + %fi is %f + %fi\n", crealf(x), cimagf(x), crealf(y), cimagf(y));
}

Example Output

The complex argument of -2.000000 + 1.000000i is 2.677945 + 0.000000i