cacos, cacosf, cacosl

Retrieves the arccosine of a complex number, with branch cuts outside the interval [-1, +1] along the real axis.


_Dcomplex cacos( _Dcomplex z );
_Fcomplex cacosf( _Fcomplex z );
_Lcomplex cacosl( _Lcomplex z );
_Fcomplex cacos( _Fcomplex z );  // C++ only
_Lcomplex cacos( _Lcomplex z );  // C++ only


A complex number that represents an angle, in radians.

Return value

The arc cosine of z, in radians. The result is unbounded along the imaginary axis, and bounded in the interval [0, π] along the real axis. A domain error will occur if z is outside the interval [-1, +1].


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


Routine C header C++ header
cacos, cacosf, cacosl <complex.h> <ccomplex>

For more compatibility information, see Compatibility.

See also

Alphabetical function reference
catanh, catanhf, catanhl
ctanh, ctanhf, ctanhl
catan, catanf, catanl
csinh, csinhf, csinhl
casinh, casinhf, casinhl
ccosh, ccoshf, ccoshl
cacosh, cacoshf, cacoshl
ctan, ctanf, ctanl
csin, csinf, csinl
casin, casinf, casinl
ccos, ccosf, ccosl
csqrt, csqrtf, csqrtl