copysign, copysignf, copysignl

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

數值

常用數學函式

浮點環境 (C99)

偽隨機數生成

複數運算 (C99)

型別通用數學 (C99)

位操作 (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) 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: TBD)

• F.10.8.1 copysign 函式（p: 待定）

• C17 標準 (ISO/IEC 9899:2018)

• 7.12.11.1 copysign 函式（p: 待定）

• 7.25 型別通用數學 <tgmath.h> (p: TBD)

• 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++ documentation for copysign