CKTIS / C++
Operátor <=> — trojcestné porovnávanie
Operátor <=>, nazývaný aj spaceship, opisuje usporiadanie hodnôt. Štandardné kategórie výsledkov rozlišujú menšie, ekvivalentné, väčšie a niekedy neusporiadané hodnoty. V triede umožňuje predvolená definícia lexikografické porovnávanie podobjektov.
Verzia: C++23; repository compiler flag; example execution verified in isolation, production runtime not attested
Syntax
a <=> b
auto operator<=>(const T&) const = default;Vstavaný operátor vo výraze a <=> b vracia hodnotu typu štandardnej kategórie porovnávania, nie hodnotu typu bool. Používateľom definovaný operator<=> môže vracať bool. Vstavané porovnania celých čísel vracajú std::strong_ordering, zatiaľ čo porovnania čísel s pohyblivou desatinnou čiarkou vracajú std::partial_ordering. Pridajte <compare>. Výsledok štandardnej kategórie testujte pomocou result < 0, result == 0 alebo result > 0; nepovažujte ho za celé číslo s hodnotou -1, 0 alebo 1.
std::strong_ordering opisuje úplné usporiadanie s rovnosťou; std::weak_ordering pripúšťa ekvivalentné hodnoty, ktoré nemusia byť zameniteľné pri pozorovaní stavu podstatného pre porovnávanie. std::partial_ordering navyše pripúšťa unordered, napríklad pri porovnaní s NaN. V takom prípade sú všetky tri testy < 0, == 0 a > 0 false; negácia jedného testu sama osebe neurčuje opačný vzťah.
V triede auto operator<=>(const T&) const = default; porovnáva lexikograficky: najprv priame základné triedy, potom nestatické dátové členy v poradí deklarácie. Prvý výsledok odlišný od nuly porovnávanie ukončí, aj keď je unordered. Návratový typ zodpovedá najslabšej kategórii podobjektov. Ak požadované porovnanie niektorého podobjektu nie je dostupné, predvolený operátor môže byť definovaný ako odstránený.
Riešenie preťažení môže využiť <=> na podporu <, <=, > a >=; nevytvorí tým štyri samostatné funkcie. Predvolený <=> deklarovaný v triede tiež implicitne deklaruje predvolený operator==, ak trieda nedeklaruje vlastný operator==; != môže využiť ==. Ručne implementovaný <=> sám osebe == neposkytuje.
V príklade rozhodne o porovnaní x ešte pred y: 1 < 2, takže a < b platí napriek tomu, že 9 > 0. Príklad je určený na kompiláciu s -std=c++23. Jeho spustenie bolo overené v izolovanom prostredí. Zdroje predstavujú priebežne sa vyvíjajúci pracovný návrh, nie zmrazený text C++23.
Prí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ýsledok
true true false
Zobrazený kód bol spustený bez zmien v izolovanom prostredí. Štandardný výstup (`stdout`) sa presne zhodoval s uvedeným výstupom.