std::nan, std::nanf, std::nanl

来自cppreference.com
< cpp‎ | numeric‎ | math
 
C++
 
数值库
常用数学函数
数学特殊函数 (C++17)
数学常数 (C++20)
基本线性代数算法 (C++26)
浮点环境 (C++11)
复数
数值数组
伪随机数生成
因数运算
(C++17)
(C++17)
插值
(C++20)
(C++20)
饱和算术
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)

泛型算术运算
位操作
(C++20)    
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++23)
(C++20)
 
常用数学函数
函数
基本运算
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
nannanfnanl
(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> 定义
float       nanf( const char* arg );
 (1) (C++11 起)
double      nan ( const char* arg );
 (2) (C++11 起)
long double nanl( const char* arg );
 (3) (C++11 起)

分别如同通过调用 std::strtof、std::strtod 或 std::strtold 将字符串 arg 转换成对应的安静 NaN 值。

1) 调用 std::nan("n字符序列")，其中 n字符序列 是数字、拉丁字母和下划线的序列，等价于调用 std::strtof("NAN(n字符序列)", (char**)nullptr);。
调用 std::nan("") 等价于调用 std::strtof("NAN()", (char**)nullptr);。
调用 std::nan("字符串")，其中 字符串 既不是 n字符序列 也不是空字符串，等价于调用 std::strtof("NAN", (char**)nullptr);。
2) 同 (1)，但等价调用的是 std::strtod 而非 std::strtof。
3) 同 (1)，但等价调用的是 std::strtold 而非 std::strtof。

目录

[编辑] 参数

arg - 标识 NaN 内容的窄字符串

[编辑] 返回值

返回对应标识字符串 arg 的安静 NaN 值，或在实现不支持安静 NaN 时返回零。

如果实现支持 IEEE 浮点算术（IEC 60559），那么它也支持安静 NaN。

[编辑] 错误处理

此函数不受制于任何指定于 math_errhandling 的错误条件。

[编辑] 示例

运行此代码
#include <cmath>
#include <cstdint>
#include <cstring>
#include <iostream>
 
int main()
{
    double f1 = std::nan("1");
    std::uint64_t f1n; std::memcpy(&f1n, &f1, sizeof f1);
    std::cout << "nan(\"1\") = " << f1 << " (" << std::hex << f1n << ")\n";
 
    double f2 = std::nan("2");
    std::uint64_t f2n; std::memcpy(&f2n, &f2, sizeof f2);
    std::cout << "nan(\"2\") = " << f2 << " (" << std::hex << f2n << ")\n";
}

可能的输出： 

nan("1") = nan (7ff0000000000001)
nan("2") = nan (7ff0000000000002)

[编辑] 参阅

(C++11)
 检查给定的数是否 NaN
(函数) [编辑]
(C++11)
 求值为 float 类型的静默 NAN
(宏常量) [编辑]
[静态]
 鉴别能表示特殊值“安静的非数”（NaN）的浮点类型
(std::numeric_limits<T> 的公开静态成员常量) [编辑]
[静态]
 鉴别能表示特殊值“发信的非数”（NaN）的浮点类型
(std::numeric_limits<T> 的公开静态成员常量) [编辑]
[静态]
 返回给定浮点类型的安静 NaN 值
(std::numeric_limits<T> 的公开静态成员函数) [编辑]
[静态]
 返回给定浮点类型的发信的 NaN
(std::numeric_limits<T> 的公开静态成员函数) [编辑]
nanf, nan, nanl 的 C 文档
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/numeric/math/nan&oldid=87270”