Namespaces
Variants

std:: isunordered

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(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)
Types
(C++11)
(C++11)
(C++11)
Macro constants
定義先ヘッダ <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 ( /* floating-point-type */ x,
/* floating-point-type */ y ) ;
(C++23以降)
定義先ヘッダ <cmath>
template < class Arithmetic1, class Arithmetic2 >
bool isunordered ( Arithmetic1 x, Arithmetic2 y ) ;
(A) (C++11以降)
(constexpr C++23以降)
1) 浮動小数点数 x と y が非順序化されているかどうかを判定します。つまり、一方または両方がNaNであり、互いに意味のある比較ができない状態であることを示します。 ライブラリは、パラメータ x と y の型として、すべてのcv修飾されていない浮動小数点型に対するオーバーロードを提供します。 (C++23以降)
A) その他の算術型のすべての組み合わせに対して、追加のオーバーロードが提供されています。

目次

パラメータ

x, y - 浮動小数点または整数値

戻り値

true xまたはyのいずれかがNaNの場合、 false それ以外の場合。

注記

追加のオーバーロードは (A) と完全に同一である必要はありません。それらは、第一引数 num1 と第二引数 num2 に対して以下を保証するのに十分なものであればよいのです：

  • num1 または num2 の型が 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 ) )     と同じ効果を持つ。
  • それ以外の場合、 num1 または num2 の型が float の場合、 std :: isunordered ( num1, num2 ) は std :: isunordered ( static_cast < float > ( num1 ) ,
    static_cast < float > ( num2 ) )     と同じ効果を持つ。
(C++23まで)

num1 と num2 が算術型を持つ場合、 std :: isunordered ( num1, num2 ) は std :: isunordered ( static_cast < /*common-floating-point-type*/ > ( num1 ) ,
static_cast < /*common-floating-point-type*/ > ( num2 ) ) と同じ効果を持つ。ここで /*common-floating-point-type*/ は num1 と num2 の型の間で最大の 浮動小数点変換ランク と最大の 浮動小数点変換サブランク を持つ浮動小数点型であり、整数型の引数は 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)
指定された浮動小数点値を分類する
(関数)
(C++11)
指定された数値がNaNかどうかをチェックする
(関数)
Cドキュメント for isunordered