std::signbit

来自cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基础运算
(C++11)  
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
指数函数
(C++11)
(C++11)

(C++11)
(C++11)
幂函数
(C++11)
(C++11)
三角双曲函数
(C++11)
(C++11)
(C++11)

误差与伽马函数
(C++11)
(C++11)
(C++11)
(C++11)
浮点数的最接近整数
(C++11)(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)(C++11)
浮点数操作函数
(C++11)(C++11)
(C++11)
(C++11)
(C++11)(C++11)
(C++11)
分类与比较
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
signbit
(C++11)
(C++11)
(C++11)
类型
(C++11)
(C++11)
(C++11)
宏常量
分类
(C++11)(C++11)(C++11)(C++11)(C++11)


 
在标头 <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
(参见 math-floating-pointdeduced-simd-t 的定义。)
(C++26 起)
A) 为所有整数类型提供额外重载,将它们当做 double

目录

[编辑] 参数

num - 浮点数或整数
v_num - std::basic_simd 的特化类型的数据并行对象,其元素类型是浮点数类型

[编辑] 返回值

1)num 为负时返回 true,否则返回 false
S) 返回一个数据并行掩模对象,对于范围 [0v_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

[编辑] 参阅

浮点数的绝对值(|x|
(函数) [编辑]
(C++11)(C++11)(C++11)
复制浮点数的符号
(函数) [编辑]
signbit 的 C 文档