Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Operatore <=> — confronto a tre vie

L’operatore <=>, chiamato «spaceship», descrive una relazione d’ordine tra valori. Le categorie di risultato standard distinguono minore, equivalente, maggiore e talvolta non ordinato. In una classe, una definizione predefinita consente il confronto lessicografico dei sotto-oggetti.

Versione: C++23; repository compiler flag; example execution verified in isolation, production runtime not attested

Sintassi

a <=> b
 auto operator<=>(const T&) const = default;

In a <=> b, l’operatore integrato restituisce un valore di un tipo di categoria di confronto standard, non un bool. Un operator<=> definito dall’utente può restituire bool. I confronti integrati tra interi restituiscono std::strong_ordering, mentre quelli tra numeri in virgola mobile restituiscono std::partial_ordering. Includi <compare>. Verifica un risultato di categoria standard con result < 0, result == 0 o result > 0; non trattarlo come un intero che contiene -1, 0 o 1.

std::strong_ordering descrive un ordine totale con uguaglianza; std::weak_ordering consente valori equivalenti che non devono necessariamente essere sostituibili nelle osservazioni dello stato rilevante per il confronto. std::partial_ordering consente anche unordered, per esempio nel confronto con NaN. In tal caso, tutti e tre i test < 0, == 0 e > 0 restituiscono false; negare un test non stabilisce da solo la relazione opposta.

In una classe, auto operator<=>(const T&) const = default; confronta in modo lessicografico: prima le classi base dirette, poi i membri dati non statici, nell’ordine di dichiarazione. Il primo risultato diverso da zero conclude il confronto, anche se è unordered. Il tipo restituito riflette la categoria più debole dei sotto-oggetti. Se non è disponibile un confronto richiesto per un sotto-oggetto, l’operatore predefinito può essere definito come eliminato.

La risoluzione degli overload può usare <=> per supportare <, <=, > e >=; questo non genera quattro funzioni separate. Un <=> predefinito dichiarato all’interno di una classe dichiara anche implicitamente un operator== predefinito se la classe non ne dichiara uno proprio; != può usare ==. Un <=> implementato manualmente non fornisce da solo ==.

Nell’esempio, x decide il confronto prima di y: 1 < 2, quindi a < b è vero nonostante 9 > 0. L’esempio è destinato alla compilazione con -std=c++23. L’esecuzione è stata verificata in un ambiente isolato. Le fonti presentano un progetto in evoluzione, non un testo C++23 definitivo.

Esempi

#include <compare>
#include <iostream>

struct Point {
    int x;
    int y;
    auto operator<=>(const Point&) const = default;
};

int main() {
    const Point a{1, 9};
    const Point b{2, 0};
    const auto result = a <=> b;
    std::cout << std::boolalpha
              << (result < 0) << '\n'
              << (a < b) << '\n'
              << (a == b) << '\n';
}

Risultato

true
true
false

Il codice mostrato è stato eseguito senza modifiche in un ambiente isolato. L’output standard (`stdout`) corrispondeva esattamente all’output indicato.

Fonti