cos
, cosf
, cosl
Calculates the cosine.
Syntax
double cos( double x );
float cosf( float x );
long double cosl( long double x );
#define cos(X) // Requires C11 or higher
float cos( float x ); // C++ only
long double cos( long double x ); // C++ only
Parameters
x
Angle in radians.
Return value
The cosine of x
. If x
is greater than or equal to 263, or less than or equal to -263, a loss of significance in the result occurs.
Input | SEH exception | _matherr exception |
---|---|---|
± QNaN, IND | none | _DOMAIN |
± INF | INVALID |
_DOMAIN |
Remarks
Because C++ allows overloading, you can call overloads of cos
that take and return float
or long double
values. In a C program, unless you're using the <tgmath.h> macro to call this function, cos
always takes and returns a double
.
If you use the <tgmath.h> cos()
macro, the type of the argument determines which version of the function is selected. See Type-generic math for details.
By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.
Requirements
Routine | Required C header | Required C++ header |
---|---|---|
cos , cosh , cosf |
<math.h> | <cmath> or <math.h> |
cos() macro | <tgmath.h> |
For more compatibility information, see Compatibility.
Example
See the example in sin
, sinf
, sinl
.
See also
Math and floating-point support
acos
, acosf
, acosl
asin
, asinf
, asinl
atan
, atanf
, atanl
, atan2
, atan2f
, atan2l
_matherr
sin
, sinf
, sinl
tan
, tanf
, tanl