CKTIS / C++
std::strong_ordering — résultat d’un ordre fort
std::strong_ordering, défini dans <compare>, décrit le résultat d’une comparaison à trois voies : inférieur, égal ou supérieur. Il représente un ordre total avec substituabilité des valeurs égales et ne possède pas d’état unordered.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <compare>
std::strong_ordering result = a <=> b;
result < 0;
result == 0;
result > 0;std::strong_ordering est un type de catégorie de comparaison défini dans <compare>, et non un nombre ni un bool. Pour des opérandes de type int, le résultat de a <=> b est de ce type. Incluez l’en-tête avant d’utiliser l’opérateur.
Les constantes less, equal et greater représentent les trois résultats ; equivalent a la même valeur que equal. Un résultat peut être converti implicitement en std::weak_ordering ou en std::partial_ordering.
Un ordre fort suppose la substituabilité : si a == b, alors f(a) == f(b) pour les fonctions qui ne lisent que l’état pertinent pour la comparaison, accessible par des membres publics const. Le simple choix de ce type de résultat ne prouve pas cette propriété. Il n’existe pas d’état unordered ; l’opérateur intégré <=> pour les nombres à virgule flottante renvoie plutôt std::partial_ordering.
Vérifiez le sens avec result < 0, result == 0 ou result > 0. Dans ces surcharges, utilisez le littéral 0, et non une variable égale à zéro ni un autre nombre : un argument autre que le littéral 0 entraîne un comportement indéfini. Vous pouvez aussi vérifier result == std::strong_ordering::less.
L’exemple compare 7 à 12 ; la sortie attendue est donc, dans l’ordre, true, false, false. static_assert vérifie le résultat lors de la compilation. Le code source affiché a été exécuté sans modification dans un environnement isolé, et la sortie obtenue correspondait exactement à la sortie attendue. Ni cette exécution ni l’option -std=c++23 n’attestent la compatibilité avec l’environnement d’exécution en production.
Exemples
#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';
}
Résultat
true false false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.