std::signbit
来自 cppreference.cn
定义于头文件 <cmath> |
||
(1) | ||
bool signbit( float num ); bool signbit( 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 |
(S) | (自 C++26 起) |
定义于头文件 <cmath> |
||
template< class Integer > bool signbit( Integer num ); |
(A) | (自 C++11 起) (constexpr 自 C++23 起) |
1) 确定给定的浮点数 num 是否为负数。 库为所有 cv 限定的非限定浮点类型提供了作为形参 num 类型的重载。(自 C++23 起)
S) SIMD 重载对 v_num 执行元素级的
std::signbit 操作。
|
(自 C++26 起) |
A) 为所有整数类型提供了额外的重载,这些整数类型被视为 double。
目录 |
[编辑] 参数
num | - | 浮点值或整数值 |
v_num | - | 元素类型为浮点类型的 std::basic_simd 特化的数据并行对象 |
[编辑] 返回值
1) 如果 num 为负,则返回 true,否则返回 false。
S) 数据并行掩码对象,其中第 i 个元素等于 true 如果 v_num[i] 为负,否则为 false,对于范围
[
0,
v_num.size())
中的所有 i。[编辑] 注解
此函数检测零、无穷大和 NaN 的符号位。与 std::copysign 一起,std::signbit
是仅有的两种可移植的方式之一,用于检查 NaN 的符号。
不需要完全按照 (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) |
复制浮点值的符号 (函数) |
C 文档 关于 signbit
|