Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Calculates the sine of a floating-point value.
Syntax
double sin(double x);
float sinf(float x);
long double sinl(long double x);
#define sin(x) // Requires C11 or later
float sin(float x); // C++ only
long double sin(long double x); // C++ only
Parameters
x
Angle in radians.
Return value
The sin functions return the sine 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 (sin, sinf, sinl) |
INVALID |
_DOMAIN |
For more information about return codes, see errno, _doserrno, _sys_errlist, and _sys_nerr.
Remarks
Because C++ allows overloading, you can call overloads of sin 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, sin always takes and returns double.
If you use the <tgmath.h> sin() 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 header (C) | Required header (C++) |
|---|---|---|
sin, sinf, sinl |
<math.h> |
<cmath> or <math.h> |
sin macro |
<tgmath.h> |
For more compatibility information, see Compatibility.
Example
// crt_sincos.c
// This program displays the sine and cosine of pi / 2.
// Compile by using: cl /W4 crt_sincos.c
#include <math.h>
#include <stdio.h>
int main( void)
{
double pi = 3.1415926535;
double x, y;
x = pi / 2;
y = sin( x );
printf( "sin( %f ) = %f\n", x, y );
y = cos( x );
printf( "cos( %f ) = %f\n", x, y );
}
sin( 1.570796 ) = 1.000000
cos( 1.570796 ) = 0.000000
See also
Math and floating-point support
acos, acosf, acosl
asin, asinf, asinl
atan, atanf, atanl, atan2, atan2f, atan2l
cos, cosf, cosl
tan, tanf, tanl
_CIsin