命名空间
变体
操作

sinpi, sinpif, sinpil, sinpid32, sinpid64, sinpid128

来自 cppreference.cn
< c‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本操作
(C99)
(C99)
(C99)
(C99)(C99)(C99)(C23)
最大值/最小值操作
(C99)
(C99)
指数函数
(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)
(C23)(C23)(C23)(C23)
浮点数操作
(C99)(C99)
(C99)(C23)
(C99)
窄化操作
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
量子和量子指数
十进制重新编码函数
总阶数和有效载荷函数
分类
(C99)
(C99)
(C99)
(C23)
误差和伽玛函数
(C99)
(C99)
(C99)
(C99)
类型
宏常量
特殊浮点数值
(C99)(C23)
参数和返回值
错误处理
快速操作指示符
 
定义于头文件 <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)

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

(自 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))
(函数) [编辑]