copysign, copysignf, copysignl

类型

div_tldiv_tlldiv_timaxdiv_t (C99)(C99)

float_tdouble_t (C99)(C99)
_Decimal32_t_Decimal64_t (C23)(C23)

函数

基本运算

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)

宏常量

特殊浮点值

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_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23)

FP_LLOGB0FP_LLOGBNAN (C23)(C23)
FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

错误处理

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 The copysign functions （第 TBD 页）

7.25 Type-generic math <tgmath.h> （第 TBD 页）

F.10.8.1 The copysign functions （第 TBD 页）

C17 标准（ISO/IEC 9899:2018）：

7.12.11.1 The copysign functions （第 TBD 页）

7.25 Type-generic math <tgmath.h> （第 TBD 页）

F.10.8.1 The copysign functions （第 TBD 页）

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

7.12.11.1 The copysign functions （第 255 页）

7.25 Type-generic math <tgmath.h> （第 373-375 页）

F.10.8.1 The copysign functions （第 529 页）

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

7.12.11.1 The copysign functions （第 236 页）

7.22 Type-generic math <tgmath.h> （第 335-337 页）

F.9.8.1 The copysign functions （第 465 页）

参阅

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

编译器支持
语言
头文件
类型支持
程序工具
变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

常用数学函数
浮点环境 (C99)
伪随机数生成
复数算术 (C99)
泛型数学函数 (C99)

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

copysign, copysignf, copysignl

参数

返回值

错误处理

注意

示例

引用

参阅

导航