Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::strong_ordering — risultato di un ordinamento forte

std::strong_ordering di <compare> descrive il risultato di un confronto a tre vie: minore, uguale o maggiore. Rappresenta un ordine totale con sostituibilità dei valori uguali e non prevede uno stato unordered.

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

Sintassi

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

std::strong_ordering è un tipo di categoria di confronto definito in <compare>, non un numero né un bool. Per operandi di tipo int, il risultato di a <=> b è di questo tipo. Includi l’header prima di usare l’operatore.

Le costanti less, equal e greater rappresentano i tre esiti; equivalent ha lo stesso valore di equal. Un risultato può essere convertito implicitamente in std::weak_ordering o std::partial_ordering.

Un ordinamento forte presuppone la sostituibilità: se a == b, allora f(a) == f(b) per le funzioni che leggono solo lo stato rilevante per il confronto, accessibile tramite membri pubblici const. La sola scelta di questo tipo di risultato non dimostra tale proprietà. Non esiste uno stato unordered; l’operatore integrato <=> per i numeri in virgola mobile restituisce invece std::partial_ordering.

Verifica la direzione con result < 0, result == 0 o result > 0. In questi overload usa il letterale 0, non una variabile con valore zero né un altro numero: un argomento diverso dal letterale 0 causa comportamento indefinito. Puoi anche verificare result == std::strong_ordering::less.

L’esempio confronta 7 con 12, quindi l’output previsto è true, false, false, in quest’ordine. static_assert controlla il risultato durante la compilazione. Il codice sorgente mostrato è stato eseguito senza modifiche in un ambiente isolato e l’output ha coinciso esattamente con quello previsto. Né questa esecuzione né l’opzione -std=c++23 attestano la compatibilità con l’ambiente di esecuzione in produzione.

Esempi

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

Risultato

true
false
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti