CKTIS / C++
Operator <=> — porównanie trójstronne
Operator <=>, nazywany spaceship, opisuje relację porządku między wartościami. Standardowe kategorie wyniku rozróżniają mniejszość, równoważność, większość, a czasem nieporównywalność. W klasie definicja = default pozwala porównywać składowe leksykograficznie.
Wersja: C++23; repository compiler flag; example execution verified in isolation, production runtime not attested
Składnia
a <=> b
auto operator<=>(const T&) const = default;Wbudowany operator w wyrażeniu a <=> b zwraca wynik należący do standardowej kategorii porównania, a nie wartość typu bool. Zdefiniowany przez użytkownika operator<=> może zwracać bool. Wbudowane porównania liczb całkowitych zwracają std::strong_ordering, a zmiennoprzecinkowych — std::partial_ordering. Dołącz <compare>. Wynik standardowej kategorii sprawdzaj przez result < 0, result == 0 lub result > 0; nie traktuj go jako liczby -1, 0 albo 1.
std::strong_ordering opisuje porządek całkowity z równością; std::weak_ordering dopuszcza równoważne wartości, które nie muszą być wzajemnie zastępowalne w obserwacjach dotyczących stanu istotnego dla porównania. std::partial_ordering dodatkowo dopuszcza unordered, np. przy porównaniu z NaN. Wtedy wszystkie trzy testy < 0, == 0 i > 0 dają false; samo zaprzeczenie jednego testu nie ustala przeciwnej relacji.
W klasie auto operator<=>(const T&) const = default; porównuje leksykograficznie najpierw bezpośrednie klasy bazowe, potem niestatyczne pola, w kolejności deklaracji. Pierwszy wynik różny od zera kończy porównanie, także gdy jest to unordered. Typ wyniku uwzględnia najsłabszą kategorię składowych. Jeśli wymagane porównanie składowej nie jest dostępne, domyślny operator może zostać zdefiniowany jako usunięty.
Rozstrzyganie przeciążeń może wykorzystać <=> do obsługi <, <=, > i >=; nie oznacza to wygenerowania czterech osobnych funkcji. Domyślny <=> zadeklarowany w klasie powoduje też niejawną deklarację domyślnego operator==, jeśli klasa nie deklaruje własnego operator==; != może korzystać z ==. Ręcznie napisany <=> sam nie zapewnia ==.
W przykładzie x rozstrzyga porównanie przed y: 1 < 2, więc a < b jest prawdą mimo 9 > 0. Przykład jest przeznaczony do kompilacji z -std=c++23. Uruchomienie przykładu zweryfikowano w odizolowanym środowisku. Źródła przedstawiają rozwijany projekt standardu, a nie zamrożony tekst C++23.
Przykłady
#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';
}
Wynik
true true false
Wyświetlony kod uruchomiono bez zmian w odizolowanym środowisku. Standardowe wyjście (`stdout`) było dokładnie zgodne z podanym wynikiem.