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

定义于头文件 `<cmath>`
float nanf( const char* arg );	(1)	(since C++11)
double nan ( const char* arg );	(2)	(since C++11)
long double nanl( const char* arg );	(3)	(since 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++26)
技术规范
符号索引
外部库

cppreference.cn

命名空间

变体

视图

操作