QPartialOrdering Class
QPartialOrdering représente le résultat d'une comparaison pouvant aboutir à des résultats non ordonnés. En savoir plus...
| En-tête : | #include <QPartialOrdering> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Depuis : | Qt 6.0 |
Fonctions publiques
| QPartialOrdering(std::partial_ordering stdorder) | |
| operator std::partial_ordering() const |
Membres publics statiques
| const QPartialOrdering | Equivalent |
| const QPartialOrdering | Greater |
| const QPartialOrdering | Less |
| const QPartialOrdering | Unordered |
| const QPartialOrdering | equivalent |
| const QPartialOrdering | greater |
| const QPartialOrdering | less |
| const QPartialOrdering | unordered |
Éléments non-membres associés
(since 6.7) bool | is_eq(QPartialOrdering o) |
(since 6.7) bool | is_gt(QPartialOrdering o) |
(since 6.7) bool | is_gteq(QPartialOrdering o) |
(since 6.7) bool | is_lt(QPartialOrdering o) |
(since 6.7) bool | is_lteq(QPartialOrdering o) |
(since 6.7) bool | is_neq(QPartialOrdering o) |
| bool | operator!=(QPartialOrdering lhs, QPartialOrdering rhs) |
| bool | operator==(QPartialOrdering lhs, QPartialOrdering rhs) |
Description détaillée
Une valeur de type QPartialOrdering est généralement renvoyée par une fonction de comparaison à trois éléments. Une telle fonction compare deux objets, détermine s’ils sont ordonnés et, le cas échéant, établit leur ordre. Elle utilise ce type de retour pour indiquer que l’ordre est partiel ; c’est-à-dire que toutes les paires de valeurs ne sont pas ordonnées.
QPartialOrdering prend quatre valeurs, représentées par les constantes symboliques suivantes :
- less indique que l’opérande de gauche est inférieur à celui de droite ;
- equivalent indique que les deux opérandes sont équivalents ;
- greater indique que l’opérande de gauche est supérieur à celui de droite ;
- unordered indique que les deux opérandes ne sont pas ordonnés.
QPartialOrdering s'utilise de manière idiomatique en comparant une instance à un zéro littéral, par exemple comme ceci :
// given a, b, c, d as objects of some type that allows for a 3-way compare,
// and a compare function declared as follows:
QPartialOrdering compare(T lhs, T rhs); // defined out-of-line
~~~
QPartialOrdering result = compare(a, b);
if (result < 0) {
// a is less than b
}
if (compare(c, d) >= 0) {
// c is greater than or equal to d
}La comparaison de ` QPartialOrdering::unordered ` avec le littéral 0 renvoie toujours un résultat de type ` false `.
Voir également Qt::strong_ordering, Qt::weak_ordering et la présentation des types de comparaison.
Documentation sur les fonctions membres
[constexpr noexcept] QPartialOrdering::QPartialOrdering(std::partial_ordering stdorder)
Crée un objet `QPartialOrdering` à partir de ` stdorder ` en appliquant les règles suivantes :
- std::partial_ordering::less se convertit en less.
- std::partial_ordering::equivalent est converti en equivalent.
- std::partial_ordering::greater est converti en greater.
- std::partial_ordering::unordered se convertit en unordered
[constexpr noexcept] QPartialOrdering::operator std::partial_ordering() const
Convertit cette valeur de type ` QPartialOrdering ` en un objet `std::partial_ordering` en appliquant les règles suivantes :
- less se convertit en std::partial_ordering::less.
- equivalent convertit en std::partial_ordering::equivalent.
- greater convertit en std::partial_ordering::greater.
- unordered convertit en std::partial_ordering::unordered.
Documentation sur les variables membres
const QPartialOrdering QPartialOrdering::Equivalent
Représente le résultat d'une comparaison dans laquelle les deux opérandes sont équivalents.
const QPartialOrdering QPartialOrdering::Greater
Représente le résultat d'une comparaison dans laquelle l'opérande de gauche est supérieur à l'opérande de droite.
const QPartialOrdering QPartialOrdering::Less
Représente le résultat d'une comparaison dans laquelle l'opérande de gauche est inférieur à l'opérande de droite.
const QPartialOrdering QPartialOrdering::Unordered
Représente le résultat d'une comparaison dans laquelle il n'existe aucune relation d'ordre entre les deux opérandes.
const QPartialOrdering QPartialOrdering::equivalent
Représente le résultat d'une comparaison dans laquelle les deux opérandes sont équivalents.
const QPartialOrdering QPartialOrdering::greater
Représente le résultat d'une comparaison dans laquelle l'opérande de gauche est supérieur à l'opérande de droite.
const QPartialOrdering QPartialOrdering::less
Représente le résultat d'une comparaison dans laquelle l'opérande de gauche est inférieur à l'opérande de droite.
const QPartialOrdering QPartialOrdering::unordered
Représente le résultat d'une comparaison pour laquelle il n'existe aucune relation d'ordre entre les deux opérandes.
Éléments non membres associés
[constexpr noexcept, since 6.7] bool is_eq(QPartialOrdering o)
[constexpr noexcept, since 6.7] bool is_gt(QPartialOrdering o)
[constexpr noexcept, since 6.7] bool is_gteq(QPartialOrdering o)
[constexpr noexcept, since 6.7] bool is_lt(QPartialOrdering o)
[constexpr noexcept, since 6.7] bool is_lteq(QPartialOrdering o)
[constexpr noexcept, since 6.7] bool is_neq(QPartialOrdering o)
Convertit une expression de type « o » en le résultat de l'un des six opérateurs relationnels suivants :
| Fonction | Opération |
|---|---|
is_eq | o == 0 |
is_neq | o != 0 |
is_lt | o < 0 |
is_lteq | o <= 0 |
is_gt | o > 0 |
is_gteq | o >= 0 |
Ces fonctions sont fournies à des fins de compatibilité avec std::partial_ordering.
Ces fonctions ont été introduites dans Qt 6.7.
[constexpr noexcept] bool operator!=(QPartialOrdering lhs, QPartialOrdering rhs)
Renvoie « true » si lhs et rhs renvoient des résultats différents ; sinon, renvoie « true ».
[constexpr noexcept] bool operator==(QPartialOrdering lhs, QPartialOrdering rhs)
Renvoie « true » si lhs et rhs renvoient le même résultat ; sinon, renvoie « false ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
