std::copysign, std::copysignf, std::copysignl
提供: cppreference.com
<tbody>
</tbody>
| ヘッダ <cmath> で定義
|
||
float copysign ( float x, float y ); float copysignf( float x, float y ); |
(1) | (C++11以上) |
double copysign ( double x, double y ); |
(2) | (C++11以上) |
long double copysign ( long double x, long double y ); long double copysignl( long double x, long double y ); |
(3) | (C++11以上) |
昇格後の型 copysign ( 算術型1 x, 算術型2 y ); |
(4) | (C++11以上) |
1-3)
x の絶対値と y の符号を持つ浮動小数点値を合成します。4) (1-3) でカバーされない算術型の引数のすべての組み合わせに対するオーバーロード集合または関数テンプレート。 任意の引数が整数型の場合、それは
double にキャストされます。 任意の引数が long double の場合、戻り値型も long double になり、そうでなければ戻り値型は必ず double になります。引数
| x, y | - | 浮動小数点値 |
戻り値
エラーが発生しなければ、 x の絶対値と y の符号を持つ浮動小数点値が返されます。
x が NaN の場合は y の符号を持つ NaN が返されます。
y が -0 の場合、処理系が算術演算で符号付きのゼロを一貫してサポートしていれば、結果は負のみになります。
エラー処理
この関数は math_errhandling で規定されているいかなるエラーの対象でもありません。
処理系が IEEE 浮動小数点算術 (IEC 60559) をサポートしている場合、
- 返された値は正確であり (FE_INEXACT は発生しません)、現在の丸めモードに依存しません。
ノート
std::copysign は NaN 値の符号を操作する移植性のある唯一の方法です (NaN の符号を検査するためには signbit も使用することができます)。
例
Run this code
#include <iostream>
#include <cmath>
int main(void)
{
std::cout << "copysign(1.0,+2.0) = " << std::copysign(1.0,+2.0) << '\n'
<< "copysign(1.0,-2.0) = " << std::copysign(1.0,-2.0) << '\n'
<< "copysign(inf,-2.0) = " << std::copysign(INFINITY,-2.0) << '\n'
<< "copysign(NaN,-2.0) = " << std::copysign(NAN,-2.0) << '\n';
}
出力:
copysign(1.0,+2.0) = 1
copysign(1.0,-2.0) = -1
copysign(inf,-2.0) = -inf
copysign(NaN,-2.0) = -nan
関連項目
(C++11)(C++11) |
浮動小数点値の絶対値 (|x|) を計算します (関数) |
(C++11) |
指定された数値が負かどうか調べます (関数) |
copysign の C言語リファレンス
|