命名空间
变体
操作

std::isunordered

来自 cppreference.com
< cpp‎ | numeric‎ | math
 
 
 
常用数学函数
函数
基本运算
(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)
isunordered
(C++11)
类型
(C++11)
(C++11)
(C++11)
宏常量
分类
(C++11)(C++11)(C++11)(C++11)(C++11)


 
定义在头文件 <cmath>
(1)
bool isunordered( float x, float y );

bool isunordered( double x, double y );

bool isunordered( long double x, long double y );
(自 C++11 起)
(直至 C++23)
constexpr bool isunordered( /* 浮点类型 */ x,
                            /* 浮点类型 */ y );
(自 C++23 起)
定义在头文件 <cmath>
template< class Arithmetic1, class Arithmetic2 >
bool isunordered( Arithmetic1 x, Arithmetic2 y );
(A) (自 C++11 起)
(自 C++23 起为 constexpr)
1) 确定浮点数 xy 是否无序,也就是说,一个或两个都是 NaN,因此无法进行有意义的比较。 库为所有 cv-未限定浮点类型提供重载,作为参数 xy 的类型。(自 C++23 起)
A) 为所有其他算术类型组合提供附加重载。

内容

[编辑] 参数

x, y - 浮点或整数值

[编辑] 返回值

如果 xy 是 NaN,则为 true,否则为 false

[编辑] 注释

附加重载不需要完全按照 (A) 提供。它们只需要足以确保对于它们的第一个参数 num1 和第二个参数 num2

  • 如果 num1num2 的类型为 long double,则 std::isunordered(num1, num2) 的效果与 std::isunordered(static_cast<long double>(num1),
                     static_cast<long double>(num2))
    相同。
  • 否则,如果 num1 和/或 num2 的类型为 double 或整数类型,则 std::isunordered(num1, num2) 的效果与 std::isunordered(static_cast<double>(num1),
                     static_cast<double>(num2))
    相同。
  • 否则,如果 num1num2 的类型为 float,则 std::isunordered(num1, num2) 的效果与 std::isunordered(static_cast<float>(num1),
                     static_cast<float>(num2))
    相同。
(直至 C++23)

如果 num1num2 具有算术类型,则 std::isunordered(num1, num2) 的效果与 std::isunordered(static_cast</* common-floating-point-type */>(num1),
                 static_cast</* common-floating-point-type */>(num2))
相同,其中 /* common-floating-point-type */ 是浮点类型,其具有在 num1num2 类型之间最大的 浮点转换等级 和最大的 浮点转换次级等级,整数类型的参数被认为具有与 double 相同的浮点转换等级。

如果没有具有最大等级和次级等级的这种浮点类型,则 重载解析 不会从提供的重载中产生可用的候选者。

(自 C++23 起)

[编辑] 示例

#include <cmath>
#include <iostream>
 
#define SHOW_UNORDERED(x, y) \
    std::cout << std::boolalpha << "isunordered(" \
              << #x << ", " << #y << "): " \
              << std::isunordered(x, y) << '\n'
 
int main()
{
    SHOW_UNORDERED(10, 01);
    SHOW_UNORDERED(INFINITY, NAN);
    SHOW_UNORDERED(INFINITY, INFINITY);
    SHOW_UNORDERED(NAN, NAN);
}

输出

isunordered(10, 01): false
isunordered(INFINITY, NAN): true
isunordered(INFINITY, INFINITY): false
isunordered(NAN, NAN): true

[编辑] 另请参见

对给定的浮点值进行分类
(函数) [编辑]
(C++11)
检查给定数字是否为 NaN
(函数) [编辑]
C 文档 for isunordered