Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła