std::isnormal - cppreference.com

std::isnormal

来自cppreference.com
 
C++
 
数值库
 
常用数学函数
函数
基础运算
(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)
(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)


 
在标头 <cmath> 定义
(1) 
bool isnormal( float num );
bool isnormal( double num );
bool isnormal( long double num );
(C++11 起)
(C++23 前)		 
constexpr bool isnormal( /*floating-point-type*/ num );
(C++23 起)
SIMD 重载 (C++26 起)
在标头 <simd> 定义 
template< /*math-floating-point*/ V >
constexpr typename /*deduced-simd-t*/<V>::mask_type
  isnormal ( const V& v_num );
(S) (C++26 起)
在标头 <cmath> 定义 
template< class Integer >
bool isnormal( Integer num );
(A) (C++11 起)
(C++23 起为 constexpr)
1) 确定给定的浮点数 num 是否为正规值，即不是零、非正规、无穷大或 NaN。标准库提供所有以无 cv 限定的浮点数类型作为形参 num 的类型的重载。(C++23 起)
S) SIMD 重载对 v_num 实施逐元素 isnormal}。
S) SIMD 重载对 v_num 实施逐元素 std::isnormal。
（参见 math-floating-point 和 deduced-simd-t 的定义。）
 (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。

注解

额外重载不需要以 (A) 的形式提供。它们只需要能够对它们的整数类型实参 num 确保 std::isnormal(num) 和 std::isnormal(static_cast<double>(num)) 的效果相同。

示例

运行此代码
#include <cfloat>
#include <cmath>
#include <iostream>

int main()
{
    std::cout << std::boolalpha
              << "isnormal(NaN) = " << std::isnormal(NAN) << '\n'
              << "isnormal(Inf) = " << std::isnormal(INFINITY) << '\n'
              << "isnormal(0.0) = " << std::isnormal(0.0) << '\n'
              << "isnormal(DBL_MIN/2.0) = " << std::isnormal(DBL_MIN / 2.0) << '\n'
              << "isnormal(1.0) = " << std::isnormal(1.0) << '\n';
}

输出： 

isnormal(NaN) = false
isnormal(Inf) = false
isnormal(0.0) = false
isnormal(DBL_MIN/2.0) = false
isnormal(1.0) = true

参阅