cospi、cospif、cospil、cospid32、cospid64、cospid128
来自 cppreference.com
定义在头文件 <math.h> 中 |
||
float cospif( float arg ); |
(1) | (自 C23) |
double cospi( double arg ); |
(2) | (自 C23) |
long double cospil( long double arg ); |
(3) | (自 C23) |
_Decimal32 cospid32( _Decimal32 arg ); |
(4) | (自 C23) |
_Decimal64 cospid64( _Decimal64 arg ); |
(5) | (自 C23) |
_Decimal128 cospid128( _Decimal128 arg ); |
(6) | (自 C23) |
定义在头文件 <tgmath.h> 中 |
||
#define cospi( arg ) |
(7) | (自 C23) |
1-6) 计算
π·arg
的余弦,以弧度为单位,因此将 arg 视为半周期的测量值。7) 类型泛型宏:根据 arg 的类型调用正确的函数。如果参数是整数类型,则调用 (2) (
cospi
)。
仅当实现预定义 |
(自 C23) |
内容 |
[编辑] 参数
arg | - | 浮点值,其与 π 的乘积表示以弧度为单位的角度 |
[编辑] 返回值
如果未发生错误,则返回 π·arg
(cos(π×arg)) 的余弦,范围为 [-1, +1]。
[编辑] 错误处理
错误报告方式如 math_errhandling
中所述。
如果实现支持 IEEE 浮点运算(IEC 60559)
- 如果参数为 ±0,则结果为 1.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 cospi family double cospi(double arg) { return cos(arg * (double)3.1415926535897932384626433); } #endif int main(void) { const double pi = acos(-1); // typical usage printf("cospi(1) = %f, cos(pi) = %f\n", cospi(1), cos(pi)); printf("cospi(0.5) = %f, cos(pi/2) = %f\n", cospi(0.5), cos(pi / 2)); printf("cospi(-0.75) = %f, cos(-3*pi/4) = %f\n", cospi(-0.75), cos(-3 * pi / 4)); // special values printf("cospi(+0) = %f\n", cospi(0.0)); printf("cospi(-0) = %f\n", cospi(-0.0)); // error handling feclearexcept(FE_ALL_EXCEPT); printf("cospi(INFINITY) = %f\n", cospi(INFINITY)); if (fetestexcept(FE_INVALID)) puts(" FE_INVALID raised"); }
可能的输出
cospi(1) = -1.000000, cos(pi) = -1.000000 cospi(0.5) = 0.000000, cos(pi/2) = 0.000000 cospi(-0.75) = -0.707107, cos(-3*pi/4) = -0.707107 cospi(+0) = 1.000000 cospi(-0) = 1.000000 cospi(INFINITY) = -nan FE_INVALID raised
[编辑] 参考资料
- C23 标准 (ISO/IEC 9899:2024)
- 7.12.4.12 cospi 函数 (p: 247)
- 7.27 类型泛型数学 <tgmath.h> (p: 387)
[编辑] 另请参阅
(C99)(C99) |
计算余弦 (cos(x)) (函数) |