copysign, copysignf, copysignl

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值

常用数学函数

浮点环境

复数算术

伪随机数生成

泛型数学

 

常用数学函数

函数
基本运算
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99)(C99)(C99)
指数函数
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
幂函数
sqrt cbrt (C99)	hypot (C99) pow
三角及双曲函数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
误差及伽马函数
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
临近整数的浮点运算
ceil floor roundlroundllround (C99)(C99)(C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99)(C99)(C99)
浮点数操作函数
ldexp scalbnscalbln (C99)(C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99)(C99) copysign (C99)
分类
fpclassify (C99) isfinite (C99) isinf (C99) isnan (C99) isnormal (C99) signbit (C99)	isgreater (C99) isgreaterequal (C99) isless (C99) islessequal (C99) islessgreater (C99) isunordered (C99)
类型
div_tldiv_tlldiv_timaxdiv_t (C99)(C99)	float_tdouble_t (C99)(C99)
宏常量
HUGE_VALFHUGE_VALHUGE_VALL (C99)(C99) FP_FAST_FMAFFP_FAST_FMAFP_FAST_FMAL (C99)(C99)(C99) math_errhandlingMATH_ERRNOMATH_ERRNOEXCEPT (C99)(C99)(C99)	INFINITY (C99) NAN (C99) FP_ILOGB0FP_ILOGBNAN (C99)(C99) FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

 

定义于头文件 <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 standard (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 standard (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)	计算浮点值的绝对值 （|x|） (函数)
signbit (C99)	检查给定数是不是负数 (函数)