sinpi, sinpif, sinpil, sinpid32, sinpid64, sinpid128
来自cppreference.com
在标头 <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)(sinpi)。
仅当实现预定义了 |
(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 The sinpi functions (第 247-248 页)
- 7.27 Type generic math <tgmath.h> (第 387 页)
参阅
(C99)(C99) |
计算正弦(sin(x)) (函数) |