catan, catanf, catanl

Article
06/05/2017

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at catan, catanf, catanl.

Retrieves the arctangent of a complex number with branch cuts outside the interval [−1; +1] along the imaginary axis.

Syntax

_Dcomplex catan(   
   _Dcomplex z   
);  
_Fcomplex catan(   
   _Fcomplex z   
);  // C++ only  
_Lcomplex catan(   
  _Lcomplex z   
);  // C++ only  
_Fcomplex catanf(   
   _Fcomplex z   
);  
_Lcomplex catanl(   
   _Lcomplex z   
);

Parameters

z
A complex number that represents an angle, in radians.

Return Value

The arctangent of z, in radians. The result is unbounded along the imaginary axis, and in the interval [−π/2; +π/2] along the real axis.

Remarks

Because C++ allows overloading, you can call overloads of catan that take and return _Fcomplex and _Lcomplex values. In a C program, catan always takes and returns a _Dcomplex value.

Requirements

Routine	C header	C++ header
`catan`, `catanf`, `catanl`	<complex.h>	<ccomplex>

For more compatibility information, see Compatibility in the Introduction.