copysign, copysignf, copysignl

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

数值

常用数学函数

浮点环境 (C99)

伪随机数生成

复数算术 (C99)

类型泛型数学 (C99)

位操作 (C23)

checked 整数算术 (C23)

 

常用数学函数

函数 基本运算 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小值运算 fmax (C99) fmin (C99) fmaximum (C23) fminimum (C23) fmaximum_mag (C23)  fmaximum_num (C23) fminimum_mag (C23) fminimum_num (C23) fmaximum_mag_num (C23) fminimum_mag_num (C23)   指数函数 exp exp10 (C23) exp2 (C99) expm1 (C99) exp10m1 (C23) exp2m1 (C23) log log10 log2 (C99) log1plogp1 (C99)(C23) log10p1 (C23) log2p1 (C23) 幂函数 sqrt cbrt (C99) rootn (C23) rsqrt (C23) hypot (C99) compound (C23) pow pown (C23) powr (C23) 三角函数和双曲函数 sin cos tan asin acos atan atan2 sinpi (C23) cospi (C23) tanpi (C23) asinpi (C23) acospi (C23) atanpi (C23) atan2pi (C23) sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)

最接近整数的浮点数 ceil floor roundlroundllround (C99)(C99)(C99) roundeven (C23) trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99) fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23) 浮点数操作 ldexp frexp scalbnscalbln (C99)(C99) ilogbllogb (C99)(C23) logb (C99) modf nextafternexttoward (C99)(C99) nextupnextdown (C23)(C23) copysign (C99) canonicalize (C23) 窄化操作 fadd (C23) fsub (C23) fmul (C23) fdiv (C23) ffma (C23) fsqrt (C23) 量子和量子指数 quantizedN (C23) quantumdN (C23) samequantumdN (C23) llquantexpdN (C23) 十进制重编码函数 encodedecdN (C23) decodedecdN (C23) encodebindN (C23) decodebindN (C23) 总阶数和有效载荷函数 totalorder (C23) getpayload (C23) setpayload (C23) setpayloadsig (C23) 分类 fpclassify (C99) iscanonical (C23)  isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99) issubnormal (C23) iszero (C23) isgreater (C99) isgreaterequal (C99)   isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99) issignaling (C23) iseqsig (C23)

误差函数和伽玛函数 erf (C99) erfc (C99) lgamma (C99) tgamma (C99) 类型 div_tldiv_tlldiv_timaxdiv_t (C99)(C99) float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23) 宏常量 特殊浮点数值 HUGE_VALHUGE_VALFHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数和返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23) 错误处理 MATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)  math_errhandling (C99) 快速运算指示符 FP_FAST_FMAFFP_FAST_FMA (C99)(C99) FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23) FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23) FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23) FP_FAST_FMALFP_FAST_FMADN (C99)(C23) FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23) FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23) FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

 

在头文件 <math.h> 中定义
float       copysignf( float x, float y );	(1)	(自 C99 起)
double      copysign( double x, double y );	(2)	(自 C99 起)
long double copysignl( long double x, long double y );	(3)	(自 C99 起)
在头文件 <tgmath.h> 中定义
#define copysign(x, y)	(4)	(自 C99 起)

1-3) 组合一个浮点数值，其大小为 x，符号为 y。

4) 类型泛型宏：如果任何参数的类型为 long double，则调用 copysignl。否则，如果任何参数具有整数类型或类型为 double，则调用 copysign。否则，调用 copysignf。

参数

x, y

-

浮点数值

返回值

如果没有错误发生，则返回大小为 x，符号为 y 的浮点数值。

如果 x 是 NaN，则返回符号为 y 的 NaN。

如果 y 是 -0，则仅当实现一致地支持算术运算中的带符号零时，结果才为负数。

错误处理

此函数不受 math_errhandling 中指定的任何错误的影响。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

• 返回的值是精确的（永不引发 FE_INEXACT），并且独立于当前的舍入模式。

注解

copysign 是操作 NaN 值符号的唯一可移植方法（要检查 NaN 的符号，也可以使用 signbit）。

示例

运行此代码

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("copysign(1.0,+2.0)      = %+.1f\n", copysign(1.0,+2.0));
    printf("copysign(1.0,-2.0)      = %+.1f\n", copysign(1.0,-2.0));
    printf("copysign(INFINITY,-2.0) = %f\n",    copysign(INFINITY,-2.0));
    printf("copysign(NAN,-2.0)      = %f\n",    copysign(NAN,-2.0));
}

可能的输出

copysign(1.0,+2.0)      = +1.0
copysign(1.0,-2.0)      = -1.0
copysign(INFINITY,-2.0) = -inf
copysign(NAN,-2.0)      = -nan

参考

• C23 标准 (ISO/IEC 9899:2024)

• 7.12.11.1 copysign 函数 (p: 待定)

• 7.25 类型泛型数学 <tgmath.h> (p: 待定)

• F.10.8.1 copysign 函数 (p: 待定)

• C17 标准 (ISO/IEC 9899:2018)

• 7.12.11.1 copysign 函数 (p: 待定)

• 7.25 类型泛型数学 <tgmath.h> (p: 待定)

• F.10.8.1 copysign 函数 (p: 待定)

• C11 标准 (ISO/IEC 9899:2011)

• 7.12.11.1 copysign 函数 (p: 255)

• 7.25 类型泛型数学 <tgmath.h> (p: 373-375)

• F.10.8.1 copysign 函数 (p: 529)

• C99 标准 (ISO/IEC 9899:1999)

• 7.12.11.1 copysign 函数 (p: 236)

• 7.22 类型泛型数学 <tgmath.h> (p: 335-337)

• F.9.8.1 copysign 函数 (p: 465)

参见

fabsfabsffabsl (C99)(C99)	计算浮点数值的绝对值 (\(\small{|x|}\)|x|) (函数)
signbit (C99)	检查给定数字是否为负数 (函数宏)
C++ 文档 关于 copysign