命名空间
变体
操作

std::isunordered

来自 cppreference.cn
< 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 );
(since C++11)
(until C++23)
constexpr bool isunordered( /* floating-point-type */ x,
                            /* floating-point-type */ y );
(since C++23)
定义于头文件 <cmath>
template< class Arithmetic1, class Arithmetic2 >
bool isunordered( Arithmetic1 x, Arithmetic2 y );
(A) (since C++11)
(constexpr since C++23)
1) 确定浮点数 xy 是否无序,即,是否其中一个或两个都是 NaN,因而无法有意义地相互比较。 库为所有 cv 无限定的浮点类型作为形参 xy 的类型提供重载。(since C++23)
A) 为算术类型的其他所有组合提供额外的重载。

内容

[编辑] 参数

x, y - 浮点值或整数值

[编辑] 返回值

true 如果 xy 之一是 NaN,否则为 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))
    相同的效果。
(until 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 相同的浮点转换等级。

若不存在具有最大等级和子等级的浮点类型,则重载决议不会从提供的重载中产生可用的候选项。

(since 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 文档 关于 isunordered