命名空间
变体
操作

sinpi, sinpif, sinpil, sinpid32, sinpid64, sinpid128

来自 cppreference.com
< c‎ | numeric‎ | math
 
 
 
常用数学函数
类型
(C99)(C99)    

(C99)(C99)    

函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C23)    
指数函数
(C23)
(C99)
(C99)
(C23)
(C23)
(C99)
(C99)(C23)
(C23)
(C23)
幂函数
(C99)
(C23)
(C23)
(C99)
(C23)
(C23)
三角函数和双曲函数
sinpi
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
(C99)
(C99)
(C99)
误差函数和伽马函数
(C99)
(C99)
(C99)
(C99)
最接近整数的浮点操作
(C99)(C99)(C99)
(C99)
(C99)(C99)(C99)
(C23)(C23)(C23)(C23)
浮点操作函数
(C99)(C99)
(C99)(C23)
(C99)
缩窄操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数函数
十进制重新编码函数
全序和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
宏常量
特殊浮点值
(C99)(C23)
参数和返回值
(C99)(C99)(C99)(C99)(C99)    
错误处理
(C99)    

 
在头文件 <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)

仅当实现预定义 __STDC_IEC_60559_DFP__(即实现支持十进制浮点数)时,才会声明函数 (4-6)

(自 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
// A naive implementation of a subset of sinpi family
double sinpi(double arg)
{
    return sin(arg * (double)3.1415926535897932384626433);
}
#endif
 
int main(void)
{
    const double pi = acos(-1);
 
    // typical usage
    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));
 
    // special values
    printf("sinpi(+0) = %f\n", sinpi(0.0));
    printf("sinpi(-0) = %f\n", sinpi(-0.0));
 
    // error handling
    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)
计算正弦值 (sin(x))
(函数) [编辑]