WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::strong_ordering — Ergebnis einer starken Ordnung

std::strong_ordering aus <compare> beschreibt das Ergebnis eines Dreiwegevergleichs: kleiner, gleich oder größer. Es steht für eine totale Ordnung mit Ersetzbarkeit gleicher Werte und kennt keinen Zustand unordered.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <compare>
std::strong_ordering result = a <=> b;
result < 0;
result == 0;
result > 0;

std::strong_ordering ist ein Vergleichskategorietyp aus <compare>, keine Zahl und kein bool. Das Ergebnis von a <=> b hat für Operanden vom Typ int diesen Typ. Binde den Header ein, bevor du den Operator verwendest.

Die Konstanten less, equal und greater stehen für die drei Ergebnisse; equivalent hat denselben Wert wie equal. Ein Ergebnis lässt sich implizit in std::weak_ordering oder std::partial_ordering umwandeln.

Eine starke Ordnung setzt Ersetzbarkeit voraus: Wenn a == b, gilt f(a) == f(b) für Funktionen, die nur vergleichungsrelevanten Zustand lesen, der über öffentliche const-Member zugänglich ist. Die Wahl dieses Ergebnistyps allein beweist diese Eigenschaft nicht. Es gibt keinen Zustand unordered; der eingebaute Operator <=> für Gleitkommazahlen liefert stattdessen std::partial_ordering.

Prüfe die Richtung mit result < 0, result == 0 oder result > 0. Verwende bei diesen Überladungen das Literal 0, keine Variable mit dem Wert null und keine andere Zahl: Ein Argument, das nicht das Literal 0 ist, führt zu undefiniertem Verhalten. Du kannst auch result == std::strong_ordering::less prüfen.

Das Beispiel vergleicht 7 mit 12; die erwartete Ausgabe lautet daher der Reihe nach true, false, false. static_assert prüft das Ergebnis während der Kompilierung. Der gezeigte Quellcode wurde unverändert in einer isolierten Umgebung ausgeführt, und die Ausgabe entsprach exakt der erwarteten Ausgabe. Weder diese Ausführung noch die Option -std=c++23 belegt die Kompatibilität mit der Laufzeitumgebung in der Produktion.

Beispiele

#include <compare>
#include <iostream>

int main() {
    constexpr std::strong_ordering result = 7 <=> 12;
    static_assert(result == std::strong_ordering::less);
    static_assert(std::strong_ordering::equal ==
                  std::strong_ordering::equivalent);

    std::cout << std::boolalpha
              << (result < 0) << '\n'
              << (result == 0) << '\n'
              << (result > 0) << '\n';
}

Ergebnis

true
false
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen