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.