Namespaces
Variants

    std::compare_weak_order_fallback

    ja.cppreference.net より
     
    C++
    コンパイラサポート
    フリースタンディングとホスト環境
    言語
    標準ライブラリ
    標準ライブラリヘッダ
    名前付き要件
    機能テストマクロ (C++20)
    言語サポートライブラリ
    コンセプトライブラリ (C++20)
    診断ライブラリ
    メモリ管理ライブラリ
    メタプログラミングライブラリ (C++11)
    汎用ユーティリティライブラリ
    コンテナライブラリ
    イテレータライブラリ
    レンジライブラリ (C++20)
    アルゴリズムライブラリ
    文字列ライブラリ
    テキスト処理ライブラリ
    数値ライブラリ
    日付と時間ライブラリ
    入出力ライブラリ
    ファイルシステムライブラリ (C++17)
    並行処理サポートライブラリ (C++11)
    実行制御ライブラリ (C++26)
    技術仕様
    シンボルインデックス
    外部ライブラリ
     
    ユーティリティライブラリ
    言語サポート
    型サポート (基本型、RTTI)
    ライブラリ機能テストマクロ (C++20)
    プログラムユーティリティ
    可変長引数関数
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    コルーチンサポート (C++20)
    契約サポート (C++26)
    三方比較
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    汎用ユーティリティ
    関係演算子 (C++20で非推奨)
    整数比較関数
    (C++20)(C++20)(C++20)    
    (C++20)
    Swap と 型操作
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    共通語彙型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    ヘッダ <compare> 
    inline namespace /* unspecified */ {
    inline constexpr /* unspecified */
        compare_weak_order_fallback = /* unspecified */;
}
    		で定義 (C++20以上)
    呼び出しシグネチャ
    		 
    template< class T, class U >
    requires /* see below */
constexpr std::weak_ordering
    compare_weak_order_fallback( T&& t, U&& u ) noexcept(/* see below */);
    		(C++20以上)

    部分式 と t に対して三方比較を行い、結果を型 ustd::weak_ordering で生成します。たとえ演算子 が利用できなくても同様です。 <=>

    std::decay_t<T> と std::decay_t<U> が同じ型である場合、std::compare_weak_order_fallback(t, u) は次のいずれかに式と等価です:

    • std::weak_order(t, u)、それが適格な式である場合。そうでなければ、
    • t == u ? std::weak_ordering::equivalent :
      t < u ? std::weak_ordering::less :
               std::weak_ordering::greater      、ただし式 t == u と t < u が両方とも適格であり、かつ decltype(t == u) と decltype(t < u) がそれぞれ boolean-testable をモデル化する場合。ただし t と u は一度だけ評価されます。

    それ以外のすべての場合において、std::compare_weak_order_fallback(t, u) は不適格であり、テンプレートのインスタンス化の直接の文脈で現れた場合に置換失敗を引き起こす可能性があります。

    カスタマイゼーションポイントオブジェクト

    名前 std::compare_weak_order_fallback は カスタマイゼーションポイントオブジェクト を表し、これは 関数オブジェクト のconstな リテラル semiregular クラス型である。詳細は CustomizationPointObject を参照のこと。

    例

    このコードを実行 
    #include <compare>
#include <iostream>
// <=> をサポートしない
struct Rational_1
{
    int num;
    int den; // > 0
};
inline constexpr bool operator<(Rational_1 lhs, Rational_1 rhs)
{
    return lhs.num * rhs.den < rhs.num * lhs.den;
}
inline constexpr bool operator==(Rational_1 lhs, Rational_1 rhs)
{
    return lhs.num * rhs.den == rhs.num * lhs.den;
}
// <=> をサポートする
struct Rational_2
{
    int num;
    int den; // > 0
};
inline constexpr std::weak_ordering operator<=>(Rational_2 lhs, Rational_2 rhs)
{
    return lhs.num * rhs.den <=> rhs.num * lhs.den;
}
inline constexpr bool operator==(Rational_2 lhs, Rational_2 rhs)
{
    return lhs <=> rhs == 0;
}
void print(int id, std::weak_ordering value)
{
    std::cout << id << ") ";
    if (value == 0)
        std::cout << "equal\n";
    else if (value < 0)
        std::cout << "less\n";
    else
        std::cout << "greater\n";
}
int main()
{
    Rational_1 a{1, 2}, b{3, 4};
//  print(0, a <=> b); // 動作しない
    print(1, std::compare_weak_order_fallback(a, b)); // 動作する、< と == にフォールバック
    Rational_2 c{6, 5}, d{8, 7};
    print(2, c <=> d); // 動作する
    print(3, std::compare_weak_order_fallback(c, d)); // 動作する
    Rational_2 e{2, 3}, f{4, 6};
    print(4, e <=> f); // 動作する
    print(5, std::compare_weak_order_fallback(e, f)); // 動作する
}

    出力: 

    1) less
2) greater
3) greater
4) equal
5) equal

    不具合報告

    以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

    DR 適用対象 公開時の動作 正しい動作
    LWG 2114
    ( P2167R3 )     		C++20 フォールバック機構は戻り値の型が
    bool に変換可能であることのみを要求     		制約が強化された

    関連項目

    (C++20)
    		3方向比較を実行し、型 std::weak_ordering の結果を生成する
    (カスタマイゼーションポイントオブジェクト)