# cargl Function

Calculates the argument of a long double precision complex value.

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

Include

<complex.h>

Prototype

long double complex cargl(long double 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)
{
long double complex x, y;

x = -2.0 + 1.0*I;
y = cargl(x);
printf("The complex argument of %Lf + %Lfi is %Lf + %Lfi\n", creall(x), cimagl(x), creall(y), cimagl(y));
}


Example Output

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