Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::partial_ordering — un résultat de comparaison partielle

std::partial_ordering de <compare> représente un résultat de comparaison qui peut être inférieur, équivalent, supérieur ou non ordonné. L’état unordered signifie que les valeurs sont incomparables, et non équivalentes.

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

Syntaxe

#include <compare>
std::partial_ordering r = std::partial_ordering::unordered;
r < 0;
r == 0;
r == std::partial_ordering::unordered;

std::partial_ordering de <compare> est une catégorie de résultat pour la comparaison à trois voies operator<=>. Elle permet des valeurs incomparables ; l’équivalence ne garantit pas nécessairement qu’elles soient interchangeables.

Les quatre résultats nommés sont less, equivalent, greater et unordered. Pour un résultat r, les expressions r < 0, r == 0 et r > 0 reconnaissent les trois premiers états. Pour unordered, elles sont toutes fausses, tout comme r <= 0 et r >= 0. Détectez cet état avec r == std::partial_ordering::unordered ; r != 0 seul ne le distingue pas de less et greater.

Lorsque vous comparez un résultat à zéro, utilisez le littéral 0, et non une variable ou un autre nombre. La norme exige spécifiquement le littéral ; fournir un autre argument à ce paramètre entraîne un comportement indéfini. Comparer deux objets de catégorie avec == est une opération distincte et valide.

L’exemple utilise des constantes nommées pour montrer l’incomparabilité de manière déterministe, sans dépendre de la représentation des nombres flottants.

Exemples

#include <compare>
#include <iostream>

int main() {
    constexpr auto less = std::partial_ordering::less;
    constexpr auto unordered = std::partial_ordering::unordered;

    static_assert(less < 0);
    static_assert(unordered != 0);
    static_assert(unordered == std::partial_ordering::unordered);

    std::cout << std::boolalpha;
    std::cout << (less < 0) << '\n';
    std::cout << (unordered < 0) << ' '
              << (unordered == 0) << ' '
              << (unordered > 0) << '\n';
    std::cout << (unordered == std::partial_ordering::unordered) << '\n';
}

Résultat

true
false false false
true

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.

Sources