Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje