Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::partial_ordering — wynik porównania częściowego

std::partial_ordering z nagłówka <compare> opisuje wynik porównania, który może oznaczać mniejszość, równoważność, większość lub nieporównywalność. Stan unordered nie oznacza równoważności.

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

Składnia

#include <compare>
std::partial_ordering r = std::partial_ordering::unordered;
r < 0;
r == 0;
r == std::partial_ordering::unordered;

std::partial_ordering z <compare> jest kategorią wyniku porównania trójstronnego operator<=>. Dopuszcza nieporównywalne wartości; równoważność nie musi gwarantować ich wzajemnej zastępowalności.

Cztery nazwane wyniki to less, equivalent, greater i unordered. Dla wyniku r wyrażenia r < 0, r == 0 i r > 0 rozpoznają pierwsze trzy stany. Dla unordered wszystkie trzy są fałszywe, podobnie jak r <= 0 i r >= 0. Wykrywaj ten stan przez r == std::partial_ordering::unordered; samo r != 0 nie odróżnia go od less i greater.

Przy porównywaniu wyniku z zerem używaj literału 0, nie zmiennej ani innej liczby. Standard wymaga właśnie literału; przekazanie innego argumentu do takiego parametru powoduje niezdefiniowane zachowanie. Porównanie dwóch obiektów kategorii przez == jest odrębną, poprawną operacją.

Przykład używa nazwanych stałych, aby deterministycznie pokazać nieporównywalność bez zależności od reprezentacji liczb zmiennoprzecinkowych.

Przykłady

#include <compare>
#include <iostream>

int main() {
    constexpr auto less = std::partial_ordering::less;
    constexpr auto unordered = std::partial_ordering::unordered;

    static_assert(less < 0);
    static_assert(unordered != 0);
    static_assert(unordered == std::partial_ordering::unordered);

    std::cout << std::boolalpha;
    std::cout << (less < 0) << '\n';
    std::cout << (unordered < 0) << ' '
              << (unordered == 0) << ' '
              << (unordered > 0) << '\n';
    std::cout << (unordered == std::partial_ordering::unordered) << '\n';
}

Wynik

true
false false false
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła