Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::partial_ordering — um resultado de comparação parcial

std::partial_ordering de <compare> representa um resultado de comparação que pode ser menor, equivalente, maior ou não ordenado. O estado unordered significa que os valores são incomparáveis, não que sejam equivalentes.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

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

std::partial_ordering de <compare> é uma categoria de resultado para a comparação de três vias operator<=>. Permite valores incomparáveis; a equivalência não tem necessariamente de garantir que sejam substituíveis entre si.

Os quatro resultados designados são less, equivalent, greater e unordered. Para um resultado r, as expressões r < 0, r == 0 e r > 0 identificam os três primeiros estados. Para unordered, são todas falsas, tal como r <= 0 e r >= 0. Detete esse estado com r == std::partial_ordering::unordered; r != 0, por si só, não o distingue de less e greater.

Ao comparar um resultado com zero, utilize o literal 0, não uma variável nem outro número. A norma exige especificamente o literal; fornecer outro argumento para esse parâmetro causa comportamento indefinido. Comparar dois objetos da categoria com == é uma operação distinta e válida.

O exemplo utiliza constantes com nome para demonstrar a incomparabilidade de forma determinística, sem depender da representação de vírgula flutuante.

Exemplos

#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';
}

Resultado

true
false false false
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes