copysign, copysignf, copysignl

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境 (C99)

复数算术 (C99)

伪随机数生成

泛型数学 (C99)

 

常用数学函数

函数
基本运算 abslabsllabsimaxabs (C99)(C99) fabs divldivlldivimaxdiv (C99)(C99) fmod remainder (C99) remquo (C99) fma (C99) fdim (C99) nannanfnanlnandN (C99)(C99)(C99)(C23) 最大/最小运算 fmax (C99) fmaximum (C23) fmaximum_mag (C23) fmaximum_num (C23) fmaximum_mag_num (C23) fmin (C99) fminimum (C23) fminimum_mag (C23) fminimum_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)	误差及伽马函数 erf (C99) erfc (C99) lgamma (C99) tgamma (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) samequantumdN (C23) quantumdN (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)
类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99) _Decimal32_t_Decimal64_t (C23)(C23)
宏常量
特殊浮点值 HUGE_VALFHUGE_VALHUGE_VALLHUGE_VALDN (C99)(C99)(C23) INFINITYDEC_INFINITY (C99)(C23) NANDEC_NAN (C99)(C23) 参数与返回值 FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARSTFROMZEROFP_INT_TONEARST (C23)(C23)(C23)(C23)(C23) FP_LLOGB0FP_LLOGBNAN (C23)(C23) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99) 错误处理 math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(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 <stdio.h>
#include <math.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

引用

• C11 标准（ISO/IEC 9899:2011）：

• 7.12.11.1 The copysign functions (p: 255)

• 7.25 Type-generic math <tgmath.h> (p: 373-375)

• F.10.8.1 The copysign functions (p: 529)

• C99 标准（ISO/IEC 9899:1999）：

• 7.12.11.1 The copysign functions (p: 236)

• 7.22 Type-generic math <tgmath.h> (p: 335-337)

• F.9.8.1 The copysign functions (p: 465)

参阅

fabsfabsffabsl (C99)(C99)	计算浮点值的绝对值（ \(\small{|x|}\)|x| ） (函数)
signbit (C99)	检查给定数是不是负数 (宏函数)