std::signbit
来自cppreference.com
<tbody>
</tbody>
<tbody class="t-dcl-rev t-dcl-rev-num ">
</tbody><tbody>
</tbody>
| 在标头 <cmath> 定义
|
||
| (1) | ||
bool signbit( float num ); bool signbit( double num ); bool signbit( long double num ); |
(C++11 起) (C++23 前) |
|
constexpr bool signbit( /*floating-point-type*/ num ); |
(C++23 起) | |
| SIMD 重载 (C++26 起) |
||
| 在标头 <simd> 定义
|
||
template< /*math-floating-point*/ V > constexpr typename /*deduced-simd-t*/<V>::mask_type signbit ( const V& v_num ); |
(S) | (C++26 起) |
| 在标头 <cmath> 定义
|
||
template< class Integer > bool signbit( Integer num ); |
(A) | (C++11 起) (C++23 起为 constexpr) |
1) 确定给定的浮点数
num 是否为负。标准库提供所有以无 cv 限定的浮点数类型作为形参 num 的类型的重载。(C++23 起)|
S) SIMD 重载对
v_num 实施逐元素 signbit}。S) SIMD 重载对
v_num 实施逐元素 std::signbit。
|
(C++26 起) |
A) 为所有整数类型提供额外重载,将它们当做
double。参数
| num | - | 浮点数或整数 |
| v_num | - | std::basic_simd 的特化类型的数据并行对象,其元素类型是浮点数类型 |
返回值
1) 在
num 为负时返回 true,否则返回 false。S) 返回一个数据并行掩模对象,对于范围
[0, v_num.size()) 中的所有 i,其第 i 个元素在 v_num[i] 为负 时等于 true 否则等于 false。注解
此函数检测零、无穷大和 NaN 的正负号。std::signbit 是检验 NaN 正负号的唯二可移植方式,另一方式是 std::copysign。
额外重载不需要以 (A) 的形式提供。它们只需要能够对它们的整数类型实参 num 确保 std::signbit(num) 和 std::signbit(static_cast<double>(num)) 的效果相同。
示例
运行此代码
#include <cmath>
#include <iostream>
int main()
{
std::cout << std::boolalpha
<< "signbit(+0.0) = " << std::signbit(+0.0) << '\n'
<< "signbit(-0.0) = " << std::signbit(-0.0) << '\n'
<< "signbit(+nan) = " << std::signbit(+NAN) << '\n'
<< "signbit(-nan) = " << std::signbit(-NAN) << '\n'
<< "signbit(+inf) = " << std::signbit(+INFINITY) << '\n'
<< "signbit(-inf) = " << std::signbit(-INFINITY) << '\n';
}
输出:
signbit(+0.0) = false
signbit(-0.0) = true
signbit(+nan) = false
signbit(-nan) = true
signbit(+inf) = false
signbit(-inf) = true
参阅
(C++11)(C++11) |
浮点数的绝对值(|x|) (函数) |
(C++11)(C++11)(C++11) |
复制浮点数的符号 (函数) |
signbit 的 C 文档
| |