◐ Shell
clean mode source ↗

std::nan, std::nanf, std::nanl - cppreference.com

来自cppreference.com

在标头 <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::strtofstd::strtodstd::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 值,或在实现不支持安静 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 文档