sin, sinf, sinl
來自 cppreference.com
| 定義於標頭檔案 <math.h> |
||
| float sinf( float arg ); |
(1) | (C99 起) |
| double sin( double arg ); |
(2) | |
| long double sinl( long double arg ); |
(3) | (C99 起) |
| _Decimal32 sind32( _Decimal32 arg ); |
(4) | (自 C23 起) |
| _Decimal64 sind64( _Decimal64 arg ); |
(5) | (自 C23 起) |
| _Decimal128 sind128( _Decimal128 arg ); |
(6) | (自 C23 起) |
| 定義於標頭檔案 <tgmath.h> |
||
| #define sin( arg ) |
(7) | (C99 起) |
1-3) 計算 arg（以弧度表示）的正弦值。
7) 型別泛型宏：如果引數型別為 long double，則呼叫 (3) (
sinl)。否則，如果引數為整型或 double 型別，則呼叫 (2) (sin)。否則，呼叫 (1) (sinf)。如果引數是複數，則宏呼叫相應的複數函式 (csinl、csin、csinf)。|
函式 (4-6) 僅當實現預定義 |
(自 C23 起) |
目錄 |
[編輯] 引數
| arg | - | 表示以弧度計量的角的浮點值 |
[編輯] 返回值
如果沒有發生錯誤，返回 arg 的正弦值 (sin(arg))，範圍在 [-1 ; +1] 內。
|
如果 arg 的量級較大，結果可能沒有或只有很少的意義。 |
(直到 C99) |
如果發生域錯誤，則返回實現定義的值 (支援 NaN 時返回 NaN)。
如果因下溢發生範圍錯誤，則返回正確結果（舍入後）。
[編輯] 錯誤處理
錯誤按 math_errhandling 中指定的方式報告。
如果實現支援 IEEE 浮點算術 (IEC 60559)
- 如果引數是 ±0，則原樣返回；
- 如果引數是 ±∞，則返回 NaN 並引發 FE_INVALID；
- 如果引數為 NaN，則返回 NaN。
[編輯] 注意
C 中沒有將引數為無窮大指定為定義域錯誤，但在 POSIX 中定義為定義域錯誤。
POSIX 還指定，在下溢的情況下，arg 原樣返回，如果不支援，則返回一個不大於 DBL_MIN、FLT_MIN 和 LDBL_MIN 的實現定義值。
[編輯] 示例
執行此程式碼
#include <errno.h> #include <fenv.h> #include <math.h> #include <stdio.h> #ifndef __GNUC__ #pragma STDC FENV_ACCESS ON #endif int main(void) { const double pi = acos(-1); // typical usage printf("sin(pi/6) = %f\n", sin(pi / 6)); printf("sin(pi/2) = %f\n", sin(pi / 2)); printf("sin(-3*pi/4) = %f\n", sin(-3 * pi / 4)); // special values printf("sin(+0) = %f\n", sin(0.0)); printf("sin(-0) = %f\n", sin(-0.0)); // error handling feclearexcept(FE_ALL_EXCEPT); printf("sin(INFINITY) = %f\n", sin(INFINITY)); if (fetestexcept(FE_INVALID)) puts(" FE_INVALID raised"); }
可能的輸出
sin(pi/6) = 0.500000
sin(pi/2) = 1.000000
sin(-3*pi/4) = -0.707107
sin(+0) = 0.000000
sin(-0) = -0.000000
sin(INFINITY) = -nan
FE_INVALID raised[編輯] 參考
- C23 標準 (ISO/IEC 9899:2024)
- 7.12.4.6 sin 函式 (p: TBD)
- 7.27 型別泛型數學 <tgmath.h> (p: TBD)
- F.10.1.6 sin 函式 (p: TBD)
- C17 標準 (ISO/IEC 9899:2018)
- 7.12.4.6 sin 函式 (p: 175)
- 7.25 型別通用數學 <tgmath.h> (p: 272-273)
- F.10.1.6 sin 函式 (p: 378)
- C11 標準 (ISO/IEC 9899:2011)
- 7.12.4.6 sin 函式 (p: 239-240)
- 7.25 型別通用數學 <tgmath.h> (p: 373-375)
- F.10.1.6 sin 函式 (p: 519)
- C99 標準 (ISO/IEC 9899:1999)
- 7.12.4.6 sin 函式 (p: 220)
- 7.22 型別通用數學 <tgmath.h> (p: 335-337)
- F.9.1.6 sin 函式 (p: 456)
- C89/C90 標準 (ISO/IEC 9899:1990)
- 4.5.2.6 sin 函式
[編輯] 參閱
| (C99)(C99) |
計算餘弦 (cos(x)) (函式) |
| (C99)(C99) |
計算正切 (tan(x)) (函式) |
| (C99)(C99) |
計算反正弦 (arcsin(x)) (函式) |
| (C99)(C99)(C99) |
計算復正弦 (函式) |
| C++ 文件 for sin
| |
