std::numeric_limits<T>::quiet_NaN

来自cppreference.com
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

初等字符串转换
(C++17)
(C++17)
栈踪
 
类型支持
基本类型
基础类型
定宽整数类型 (C++11)
数值极限
C 数值极限接口
运行时类型信息
类型特性
类型类别
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
类型属性
(C++11)
(C++11)
(C++14)
(C++11)
(C++11)(C++20 前)
(C++11)(C++20 中弃用)
(C++11)
类型特性常量
元函数
(C++17)
常量求值语境
受支持操作
关系与属性查询
类型修改
(C++11)(C++11)(C++11)
类型变换
(C++11)
(C++11)
(C++17)
(C++11)(C++20 前)(C++17)
 
 
static T quiet_NaN() throw();
(C++11 前)
static constexpr T quiet_NaN() noexcept;
(C++11 起)

返回特殊值“安静的非数”,以浮点类型 T 表示。仅若 std::numeric_limits<T>::has_quiet_NaN == true 才有意义。在最常见的浮点数二进制表示 IEEE 754 中,任何所有指数位均为 1 且至少有一位尾数位为 1 的值表示 NaN 。何种尾数值表示安静或发信的 NaN ,及符号位是否有意义,是实现定义的。

返回值

T std::numeric_limits<T>::quiet_NaN()
/* non-specialized */ T()
bool false
char 0
signed char 0
unsigned char 0
wchar_t 0
char8_t (C++20) 0
char16_t (C++11) 0
char32_t (C++11) 0
short 0
unsigned short 0
int 0
unsigned int 0
long 0
unsigned long 0
long long (C++11) 0
unsigned long long (C++11) 0
float 实现定义(可为 NAN
double 实现定义
long double 实现定义

注解

NaN 与自身决不比较相等。复制 NaN 可能不保留其位表示。

示例

数种生成 NaN 的方式(输出字符串是编译器指定的)

#include <iostream>
#include <limits>
#include <cmath>
 
int main()
{
    std::cout << std::numeric_limits<double>::quiet_NaN() << ' '
              << std::numeric_limits<double>::signaling_NaN() << ' '
              << std::acos(2) << ' '
              << std::tgamma(-1) << ' '
              << std::log(-1) << ' '
              << std::sqrt(-1) << ' '
              << 0 / 0.0 << '\n';
 
    std::cout << "NaN == NaN? " << std::boolalpha
              << ( std::numeric_limits<double>::quiet_NaN()
                   == std::numeric_limits<double>::quiet_NaN() ) << '\n';
}

输出:

nan nan nan nan nan -nan -nan
NaN == NaN? false

参阅

鉴别能表示特殊值“安静的非数”( NaN )的浮点类型
(公开静态成员常量)
返回给定浮点类型的发信的 NaN
(公开静态成员函数)
(C++11)(C++11)(C++11)
非数(NaN)
(函数)
(C++11)
检查给定的数是否 NaN
(函数)