sinpi, sinpif, sinpil, sinpid32, sinpid64, sinpid128
From cppreference.net
Common mathematical functions
|
|
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
定义于头文件
<math.h>
|
||
|
float
sinpif
(
float
arg
)
;
|
(1) | (C23 起) |
|
double
sinpi
(
double
arg
)
;
|
(2) | (C23 起) |
|
long
double
sinpil
(
long
double
arg
)
;
|
(3) | (C23 起) |
|
_Decimal32 sinpid32
(
_Decimal32 arg
)
;
|
(4) | (C23 起) |
|
_Decimal64 sinpid64
(
_Decimal64 arg
)
;
|
(5) | (C23 起) |
|
_Decimal128 sinpid128
(
_Decimal128 arg
)
;
|
(6) | (C23 起) |
|
定义于头文件
<tgmath.h>
|
||
|
#define sinpi( arg )
|
(7) | (C23 起) |
1-6)
计算以弧度计量的
π·arg
的正弦值，因此将
arg
视为半周期计量单位。
7)
类型泛型宏：根据
arg
的类型调用对应函数。若参数为整数类型，则调用
(2)
。
|
当且仅当实现预定义了
|
(since C23) |
目录 |
参数
| arg | - |
浮点数值，其与
π
的乘积表示以弧度计量的角度
|
返回值
若无错误发生，则返回
π·arg
的正弦值（
sin(π×arg)
），其取值范围为
[-1, +1]
。
错误处理
错误报告方式遵循
math_errhandling
中的规范。
如果实现支持 IEEE 浮点算术 (IEC 60559)：
- 若参数为 ±0，则不作修改直接返回；
- 若参数为 ±∞，则返回 NaN 并引发 FE_INVALID ；
- 若参数为 NaN，则返回 NaN。
示例
运行此代码
#include <errno.h> #include <fenv.h> #include <math.h> #include <stdio.h> #ifndef __GNUC__ #pragma STDC FENV_ACCESS ON #endif #if __STDC_VERSION__ < 202311L // sinpi函数族的子集简单实现 double sinpi(double arg) { return sin(arg * (double)3.1415926535897932384626433); } #endif int main(void) { const double pi = acos(-1); // 典型用法 printf("sinpi(1) = %f, sin(pi) = %f\n", sinpi(1), sin(pi)); printf("sinpi(0.5) = %f, sin(pi/2) = %f\n", sinpi(0.5), sin(pi / 2)); printf("sinpi(-0.75) = %f, sin(-3*pi/4) = %f\n", sinpi(-0.75), sin(-3 * pi / 4)); // 特殊值 printf("sinpi(+0) = %f\n", sinpi(0.0)); printf("sinpi(-0) = %f\n", sinpi(-0.0)); // 错误处理 feclearexcept(FE_ALL_EXCEPT); printf("sinpi(INFINITY) = %f\n", sinpi(INFINITY)); if (fetestexcept(FE_INVALID)) puts(" FE_INVALID raised"); }
可能的输出：
sinpi(1) = 0.000000, sin(pi) = 0.000000
sinpi(0.5) = 1.000000, sin(pi/2) = 1.000000
sinpi(-0.75) = -0.707107, sin(-3*pi/4) = -0.707107
sinpi(+0) = 0.000000
sinpi(-0) = -0.000000
sinpi(INFINITY) = -nan
FE_INVALID raised
参考文献
- C23 标准 (ISO/IEC 9899:2024):
-
- 7.12.4.13 sinpi 函数 (p: 247-248)
-
- 7.27 泛型数学 <tgmath.h> (p: 387)
参见
|
(C99)
(C99)
|
计算正弦值 (
\({\small\sin{x} }\)
sin(x)
)
(函数) |