Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

Operátor <=> — trojcestné porovnání

Operátor <=>, nazývaný také spaceship, popisuje uspořádání hodnot. Standardní kategorie výsledků rozlišují menší, ekvivalentní, větší a někdy neuspořádané hodnoty. Ve třídě umožňuje výchozí definice lexikografické porovnání podobjektů.

Verze: C++23; repository compiler flag; example execution verified in isolation, production runtime not attested

Syntaxe

a <=> b
 auto operator<=>(const T&) const = default;

Vestavěný operátor ve výrazu a <=> b vrací hodnotu typu standardní kategorie porovnání, nikoli hodnotu typu bool. Uživatelsky definovaný operator<=> může vracet bool. Vestavěná porovnání celých čísel vracejí std::strong_ordering, zatímco porovnání čísel s plovoucí desetinnou čárkou vracejí std::partial_ordering. Přidejte <compare>. Výsledek standardní kategorie testujte pomocí result < 0, result == 0 nebo result > 0; nepovažujte jej za celé číslo s hodnotou -1, 0 nebo 1.

std::strong_ordering popisuje úplné uspořádání s rovností; std::weak_ordering připouští ekvivalentní hodnoty, které nemusejí být zaměnitelné při pozorování stavu podstatného pro porovnání. std::partial_ordering navíc připouští unordered, například při porovnání s NaN. V takovém případě jsou všechny tři testy < 0, == 0 a > 0 false; negace jednoho testu sama o sobě neurčuje opačný vztah.

Ve třídě auto operator<=>(const T&) const = default; porovnává lexikograficky: nejprve přímé základní třídy, poté nestatické datové členy v pořadí deklarace. První výsledek různý od nuly porovnávání ukončí, a to i tehdy, když je unordered. Návratový typ odpovídá nejslabší kategorii podobjektů. Pokud požadované porovnání některého podobjektu není dostupné, může být výchozí operátor definován jako smazaný.

Řešení přetížení může využít <=> k podpoře <, <=, > a >=; nevytvoří tím čtyři samostatné funkce. Výchozí <=> deklarovaný uvnitř třídy také implicitně deklaruje výchozí operator==, pokud třída nedeklaruje vlastní operator==; != může využít ==. Ručně implementovaný <=> sám o sobě == neposkytuje.

V příkladu rozhodne o porovnání x ještě před y: 1 < 2, takže a < b platí navzdory tomu, že 9 > 0. Příklad je určen ke kompilaci s -std=c++23. Jeho spuštění bylo ověřeno v izolovaném prostředí. Zdroje představují průběžně vyvíjený pracovní návrh, nikoli zmrazený text C++23.

Příklady

#include <compare>
#include <iostream>

struct Point {
    int x;
    int y;
    auto operator<=>(const Point&) const = default;
};

int main() {
    const Point a{1, 9};
    const Point b{2, 0};
    const auto result = a <=> b;
    std::cout << std::boolalpha
              << (result < 0) << '\n'
              << (a < b) << '\n'
              << (a == b) << '\n';
}

Výsledek

true
true
false

Zobrazený kód byl spuštěn beze změn v izolovaném prostředí. Standardní výstup (`stdout`) přesně odpovídal uvedenému výstupu.

Zdroje