CKTIS / C++
Operator <=> — Drei-Wege-Vergleich
Der Operator <=>, auch „Spaceship-Operator“ genannt, beschreibt eine Ordnungsbeziehung zwischen Werten. Die standardisierten Ergebniskategorien unterscheiden kleiner, gleichwertig, größer und manchmal ungeordnet. In einer Klasse ermöglicht eine Default-Definition den lexikografischen Vergleich von Teilobjekten.
Version: C++23; repository compiler flag; example execution verified in isolation, production runtime not attested
Syntax
a <=> b
auto operator<=>(const T&) const = default;Der eingebaute Operator in a <=> b liefert einen Wert eines standardisierten Vergleichskategorietyps, keinen bool-Wert. Ein benutzerdefinierter operator<=> kann bool zurückgeben. Eingebaute Vergleiche von Ganzzahlen liefern std::strong_ordering, Vergleiche von Gleitkommazahlen std::partial_ordering. Binde <compare> ein. Prüfe ein Ergebnis einer Standardkategorie mit result < 0, result == 0 oder result > 0; behandle es nicht wie eine Ganzzahl mit dem Wert -1, 0 oder 1.
std::strong_ordering beschreibt eine totale Ordnung mit Gleichheit; std::weak_ordering erlaubt gleichwertige Werte, die bei Beobachtungen des für den Vergleich relevanten Zustands nicht unbedingt austauschbar sein müssen. std::partial_ordering erlaubt zusätzlich unordered, etwa beim Vergleich mit NaN. In diesem Fall sind alle drei Tests < 0, == 0 und > 0 false; die Verneinung eines Tests allein stellt nicht die entgegengesetzte Beziehung fest.
In einer Klasse vergleicht auto operator<=>(const T&) const = default; lexikografisch: zuerst direkte Basisklassen, dann nichtstatische Datenelemente in Deklarationsreihenfolge. Das erste Ergebnis ungleich null beendet den Vergleich, auch wenn es unordered ist. Der Rückgabetyp richtet sich nach der schwächsten Kategorie der Teilobjekte. Ist ein erforderlicher Teilobjektvergleich nicht verfügbar, kann der Default-Operator als gelöscht definiert werden.
Die Überladungsauflösung kann <=> nutzen, um <, <=, > und >= zu unterstützen; dadurch entstehen nicht vier separate Funktionen. Ein in der Klasse deklarierter defaulteter <=> deklariert außerdem implizit einen defaulteten operator==, sofern die Klasse keinen eigenen operator== deklariert; != kann == verwenden. Ein manuell implementierter <=> stellt für sich allein kein == bereit.
Im Beispiel entscheidet x den Vergleich vor y: 1 < 2, daher ist a < b trotz 9 > 0 wahr. Das Beispiel ist für die Kompilierung mit -std=c++23 gedacht. Die Ausführung wurde in einer isolierten Umgebung überprüft. Die Quellen zeigen einen fortlaufend weiterentwickelten Arbeitsentwurf, keinen eingefrorenen C++23-Text.
Beispiele
#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';
}
Ergebnis
true true false
Der gezeigte Quellcode wurde unverändert in einer isolierten Umgebung ausgeführt. Die Standardausgabe (`stdout`) stimmte exakt mit der angegebenen Ausgabe überein.