CKTIS / C++
std::strong_ordering — výsledek silného uspořádání
std::strong_ordering z <compare> popisuje výsledek trojcestného porovnání: menší, rovno nebo větší. Představuje totální uspořádání se zastupitelností stejných hodnot a nemá stav unordered.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <compare>
std::strong_ordering result = a <=> b;
result < 0;
result == 0;
result > 0;std::strong_ordering je typ kategorie porovnání z <compare>, nikoli číslo ani bool. Pro operandy typu int má výsledek a <=> b právě tento typ. Před použitím operátoru vložte příslušnou hlavičku.
Konstanty less, equal a greater označují tři výsledky; equivalent má stejnou hodnotu jako equal. Výsledek lze implicitně převést na std::weak_ordering nebo std::partial_ordering.
Silné uspořádání předpokládá zastupitelnost: pokud a == b, pak f(a) == f(b) pro funkce, které čtou pouze stav důležitý pro porovnávání a přístupný přes veřejné členy const. Samotná volba tohoto typu výsledku tuto vlastnost nedokazuje. Stav unordered neexistuje; vestavěný operátor <=> pro čísla s plovoucí desetinnou čárkou místo toho vrací std::partial_ordering.
Směr ověřte pomocí result < 0, result == 0 nebo result > 0. V těchto přetíženích použijte literál 0, nikoli proměnnou s hodnotou nula ani jiné číslo: argument odlišný od literálu 0 způsobuje nedefinované chování. Ověřit můžete také result == std::strong_ordering::less.
Příklad porovnává 7 s 12, takže očekávaný výstup je v tomto pořadí true, false, false. static_assert kontroluje výsledek při kompilaci. Zobrazený zdrojový kód byl spuštěn beze změn v izolovaném prostředí a jeho výstup se přesně shodoval s očekávaným. Ani toto spuštění, ani volba -std=c++23 nepotvrzují kompatibilitu s produkčním běhovým prostředím.
Příklady
#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';
}
Výsledek
true false false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.