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

CKTIS / C++

std::strong_ordering — resultado de uma ordenação forte

std::strong_ordering de <compare> descreve o resultado de uma comparação de três vias: menor, igual ou maior. Representa uma ordem total com substituibilidade dos valores iguais e não tem um estado unordered.

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

Sintaxe

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

std::strong_ordering é um tipo de categoria de comparação de <compare>, não um número nem um bool. Para operandos do tipo int, o resultado de a <=> b é deste tipo. Inclui o cabeçalho antes de utilizar o operador.

As constantes less, equal e greater representam os três resultados; equivalent tem o mesmo valor que equal. Um resultado pode ser convertido implicitamente em std::weak_ordering ou std::partial_ordering.

Uma ordenação forte pressupõe substituibilidade: se a == b, então f(a) == f(b) para funções que leem apenas o estado relevante para a comparação, acessível através de membros públicos const. A escolha deste tipo de resultado, por si só, não prova esta propriedade. Não existe um estado unordered; o operador integrado <=> para números de vírgula flutuante devolve, em vez disso, std::partial_ordering.

Verifique a direção com result < 0, result == 0 ou result > 0. Nestas sobrecargas, utilize o literal 0, não uma variável com valor zero nem outro número: um argumento diferente do literal 0 provoca comportamento indefinido. Também pode verificar result == std::strong_ordering::less.

O exemplo compara 7 com 12, pelo que o resultado esperado é true, false, false, por esta ordem. static_assert verifica o resultado durante a compilação. O código-fonte apresentado foi executado sem alterações num ambiente isolado e a saída correspondeu exatamente à esperada. Nem essa execução nem a opção -std=c++23 atestam a compatibilidade com o ambiente de execução em produção.

Exemplos

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

Resultado

true
false
false

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