ccos(), ccosf(), ccosl()
QNX SDP8.0C Library ReferenceAPIDeveloper
Compute the complex cosine
Synopsis:
#include <complex.h>
double complex ccos( double complex z );
float complex ccosf( float complex z );
long double complex ccosl( long double complex z );
Arguments:
- z
- The complex value that you want to get the cosine of.
Library:
- libm
- The general-purpose math library.
- libm-sve
- A library that optimizes the code for ARMv8.2 chips that have Scalable Vector Extension hardware.
Your system requirements will determine how you should work with these libraries:
- If you want only selected processes to run with the SVE version, you can include both libraries in your OS image and use the -l m or -l m-sve option to qcc to link explicitly against the appropriate one.
- If you want all processes to use the SVE version, include libm-sve.so in your OS image and set up a symbolic link from libm.so to libm-sve.so. Use the -l m option to qcc to link against the library.
Note:
Compile your program with the -fno-builtin option to prevent the compiler from using a
built-in version of the function.
Description:
These functions compute the cosine of z. The cosine is an entire function on the complex plane, and has no branch cuts.
To check for error situations, use feclearexcept() and fetestexcept(). For example:
- Call
feclearexcept(FE_ALL_EXCEPT)before calling ccos(), ccosf(), or ccosl(). - On return, if
fetestexcept(FE_ALL_EXCEPT)is nonzero, then an error has occurred.
Returns:
The cosine of z. Errors and special cases are handled as if the operation were implemented as ccosh(i * z).
These functions raise FE_INEXACT if the FPU reports that the result can't be exactly represented as a floating-point number.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Signal handler | Yes |
| Thread | Yes |
Page updated: