Edit

Share via


cacos, cacosf, cacosl

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

Syntax

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

Parameters

z
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].

Remarks

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.

Requirements

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