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) Decimal再エンコーディング関数 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 The copysign functions (p: TBD)

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

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

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

• 7.12.11.1 The copysign functions (p: TBD)

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

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

• C11標準 (ISO/IEC 9899:2011)

• 7.12.11.1 The copysign functions (p: 255)

• 7.25 型総称数学関数 <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 型総称数学関数 <tgmath.h> (p: 335-337)

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

関連項目

fabsfabsffabsl (C99)(C99)	浮動小数点値の絶対値を計算する (\(\small{|x|}\)|x|) (関数)
signbit (C99)	与えられた数値が負数かチェックする (関数マクロ)
C++ ドキュメント for copysign