std::copysign, std::copysignf, std::copysignl

定义于头文件 `<cmath>`
	(1)
float copysign ( float mag, float sgn ); double copysign ( double mag, double sgn ); long double copysign ( long double mag, long double sgn );			(直到 C++23)
constexpr /floating-point-type/ copysign ( /floating-point-type/ mag, /floating-point-type/ sgn );			(自 C++23 起)
float copysignf( float mag, float sgn );		(2)	(自 C++11 起) (constexpr 自 C++23 起)
long double copysignl( long double mag, long double sgn );		(3)	(自 C++11 起) (constexpr 自 C++23 起)
SIMD 重载 (自 C++26 起)
定义于头文件 `<simd>`
template< class V0, class V1 > constexpr /math-common-simd-t/<V0, V1> copysign ( const V0& v_mag, const V1& v_sgn );		(S)	(自 C++26 起)
附加重载 (自 C++11 起)
定义于头文件 `<cmath>`
template< class Integer > double copysign ( Integer mag, Integer sgn );		(A)	(constexpr 自 C++23 起)

1-3) 组合一个浮点值，其大小为 mag，符号为 sgn。库为所有 cv 限定符不修饰的浮点类型提供了 std::copysign 的重载，作为参数的类型。(自 C++23 起)

S) SIMD 重载对 v_mag 和 v_sgn 执行元素级的 std::copysign。

(参见 math-common-simd-t 以了解其定义。)

(自 C++26 起)

A) 为所有整数类型提供了附加重载，它们被视为 double。

(自 C++11 起)

[编辑] 参数

mag, sgn

-

浮点值或整数值

[编辑] 返回值

如果未发生错误，则返回大小为 mag，符号为 sgn 的浮点值。

如果 mag 是 NaN，则返回符号为 sgn 的 NaN。

如果 sgn 是 -0，则仅当实现一致地在算术运算中支持有符号零时，结果才为负数。

[编辑] 错误处理

此函数不受 math_errhandling 中指定的任何错误的影响。

如果实现支持 IEEE 浮点算术 (IEC 60559)，

返回的值是精确的 (永远不会引发 FE_INEXACT)，并且独立于当前的舍入模式。

[编辑] 注释

std::copysign 是操作 NaN 值符号的唯一可移植方法 (要检查 NaN 的符号，也可以使用 std::signbit)。

附加重载不需要完全按照 (A) 的形式提供。它们只需要足以确保对于它们的第一个参数 num1 和第二个参数 num2

如果 num1 或 num2 的类型为 long double，则 std::copysign(num1, num2) 具有与 std::copysign(static_cast<long double>(num1), static_cast<long double>(num2)) 相同的效果。
否则，如果 num1 和/或 num2 的类型为 double 或整数类型，则 std::copysign(num1, num2) 具有与 std::copysign(static_cast<double>(num1), static_cast<double>(num2)) 相同的效果。
否则，如果 num1 或 num2 的类型为 float，则 std::copysign(num1, num2) 具有与 std::copysign(static_cast<float>(num1), static_cast<float>(num2)) 相同的效果。

(直到 C++23)

如果 num1 和 num2 具有算术类型，则 std::copysign(num1, num2) 具有与 std::copysign(static_cast</*common-floating-point-type*/>(num1), static_cast</*common-floating-point-type*/>(num2)) 相同的效果，其中 /*common-floating-point-type*/ 是浮点转换等级最高且浮点转换子等级最高的浮点类型，介于 num1 和 num2 的类型之间，整数类型的参数被认为具有与 double 相同的浮点转换等级。

如果不存在具有最高等级和子等级的此类浮点类型，则重载解析不会从提供的重载中产生可用的候选者。

(自 C++23 起)

[编辑] 示例

运行此代码

#include <cmath>
#include <iostream>
 
int main()
{
    std::cout << std::showpos
              << "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

[编辑] 参见

abs(float)fabsfabsffabsl (C++11)(C++11)	浮点值的绝对值 ($\small{\|x\|}$ $\|x\|$ ) (函数) [编辑]
signbit (C++11)	检查给定数字是否为负数 (函数) [编辑]
C 文档 for copysign

编译器支持
独立式和宿主式
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

cppreference.cn

命名空间

变体

视图

操作