Namespaces
Variants

    std::compare_three_way

    Aus de.cppreference.net
     
    C++
     
    Bibliothek für Hilfsmittel
    Sprachunterstützung
    Typunterstützung (Basistypen, RTTI)
    Bibliotheks-Feature-Test-Makros (C++20)
    Programmhilfsmittel
    Varadische Funktionen
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Koroutinenunterstützung (C++20)
    Vertragsunterstützung (C++26)
    Drei-Wege-Vergleich
    (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)

    Allgemeine Hilfsmittel
    Vergleichsoperatoren (veraltet in C++20)
     
    Funktionsobjekte
    Funktionsaufruf
    (C++17)(C++23)
    Identitäts-Funktionsobjekt
    (C++20)
    Transparente Operator-Wrapper
    (C++14)
    (C++14)
    (C++14)
    (C++14)  
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)
    (C++14)

    Alte Binder und Adapter
    (bis C++17*)
    (bis C++17*)
    (bis C++17*)
    (bis C++17*)
    (bis C++17*)  
    (bis C++17*)
    (bis C++17*)(bis C++17*)(bis C++17*)(bis C++17*)
    (bis C++20*)
    (bis C++20*)
    (bis C++17*)(bis C++17*)
    (bis C++17*)(bis C++17*)

    (bis C++17*)
    (bis C++17*)(bis C++17*)(bis C++17*)(bis C++17*)
    (bis C++20*)
    (bis C++20*)
     
    Definiert in Header <compare>
    Definiert in Header <functional> 
    struct compare_three_way;
    		(seit C++20)

    Funktionsobjekt zur Durchführung von Vergleichen. Leitet die Parametertypen und den Rückgabetyp des Funktionsaufrufoperators ab.

    Verschachtelte Typen

    Geschachtelter Typ Definition
    is_transparent unspecified

    Memberfunktionen

    operator()
    		erhält das Ergebnis des Drei-Wege-Vergleichs beider Argumente
    (public member function)

    std::compare_three_way:: operator()

    template < class T, class U >
    constexpr auto operator ( ) ( T && t, U && u ) const ;

    Gegeben den Ausdruck std:: forward < T > ( t ) <=> std:: forward < U > ( u ) als expr :

    • Wenn die Konvertierungssequenz von T zu P oder die Konvertierungssequenz von U zu P nicht gleichheitserhaltend ist, ist das Verhalten undefiniert.
    • Andernfalls:

    Diese Überladung nimmt nur dann an der Überladungsauflösung teil, wenn std:: three_way_comparable_with < T, U > erfüllt ist.

    Beispiel

    Diesen Code ausführen 
    #include <compare>
#include <iostream>
struct Rational
{
    int num;
    int den; // > 0
    // Although the comparison X <=> Y will work, a direct call
    // to std::compare_three_way{}(X, Y) requires the operator==
    // be defined, to satisfy the std::three_way_comparable_with.
    constexpr bool operator==(Rational const&) const = default;
};
constexpr std::weak_ordering operator<=>(Rational lhs, Rational rhs)
{
    return lhs.num * rhs.den <=> rhs.num * lhs.den;
}
void print(std::weak_ordering value)
{
    value < 0 ? std::cout << "less\n" :
    value > 0 ? std::cout << "greater\n" :
                std::cout << "equal\n";
}
int main()
{
    Rational a{6, 5};
    Rational b{8, 7};
    print(a <=> b);
    print(std::compare_three_way{}(a, b));
}

    Ausgabe: 

    greater
greater

    Fehlerberichte

    Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

    DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
    LWG 3530 C++20 syntaktische Prüfungen wurden beim Vergleichen von Zeigern gelockert nur semantische Anforderungen werden gelockert

    Siehe auch

    (C++20)
    		eingeschränktes Funktionsobjekt, das x == y implementiert
    (Klasse)
    (C++20)
    		eingeschränktes Funktionsobjekt, das x ! = y implementiert
    (Klasse)
    (C++20)
    		eingeschränktes Funktionsobjekt, das x < y implementiert
    (Klasse)
    (C++20)
    		eingeschränktes Funktionsobjekt, das x > y implementiert
    (Klasse)
    (C++20)
    		eingeschränktes Funktionsobjekt, das x <= y implementiert
    (Klasse)
    (C++20)
    		eingeschränktes Funktionsobjekt, das x >= y implementiert
    (Klasse)