catan(), catanf(), catanl() — Calculate the complex arc tangent

Standards

Standards / Extensions C or C++ Dependencies

C99
Single UNIX Specification, Version 3

both

z/OS V1R7
a compiler that is designed
to support C99

Format

#include <complex.h>

double complex catan(double complex z);
float complex catanf(float complex z);
long double complex catanl(long double complex z);

General description

The catan() family of functions compute the complex arc tangent of z, with branch cuts outside the interval [-i, +i] along the imaginary axis.
Note: The following table shows the viable formats for these functions. See IEEE binary floating-point for more information about IEEE Binary Floating-Point.
Function Hex IEEE
catan X X
catanf X X
catanl X X

Returned value

The catan() family of functions return the complex arc tangent value, in the range of a strip, mathematically unbounded along the imaginary axis and in the interval [-π/2, +π/2] along the real axis.

Example

For an example of a similar function see cacos(), cexp() or cpow().

Related information