std::nan，std::nanf，std::nanl

定义在头文件中 `<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)

将字符字符串 arg 转换为相应的静默 NaN 值，如同调用 std::strtof、std::strtod 或 std::strtold 一样。

1) 调用 std::nanf("n-char-sequence")，其中 n-char-sequence 是一个数字、ASCII 字母和下划线的序列，等效于调用 std::strtof("NAN(n-char-sequence)", (char**)nullptr);.

调用 std::nanf("") 等效于调用 std::strtof("NAN()", (char**)nullptr);.

调用 std::nanf("string")，其中 string 既不是 n-char-sequence 也不是空字符串，等效于调用 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)

[编辑] 另请参阅

isnan (C++11)	检查给定数字是否为 NaN (函数) [编辑]
NAN (C++11)	计算结果为类型为 float 的静默 NaN (宏常量) [编辑]
has_quiet_NaN [静态]	标识可以表示特殊值“静默非数字”（NaN）的浮点类型 (`std::numeric_limits<T>` 的公共静态成员常量) [编辑]
has_signaling_NaN [静态]	识别可以表示特殊值“信号非数字”（NaN）的浮点类型。 (`std::numeric_limits<T>` 的公共静态成员常量) [编辑]
quiet_NaN [静态]	返回给定浮点类型的静默 NaN 值。 (`std::numeric_limits<T>` 的公共静态成员函数) [编辑]
signaling_NaN [静态]	返回给定浮点类型的信号 NaN 值。 (`std::numeric_limits<T>` 的公共静态成员函数) [编辑]
C 文档 for nanf, nan, nanl

编译器支持
独立和托管
语言
标准库
标准库头文件
命名要求
功能测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用实用程序库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
执行支持库 (C++26)
技术规范
符号索引
外部库

cppreference.com

命名空间

变体

视图

操作