Qt::weak_ordering Class
class Qt::weak_orderingQt::weak_ordering représente une comparaison dans laquelle des valeurs équivalentes restent toutefois distinguables. En savoir plus...
| En-tête : | #include <QtCompare> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Depuis : | Qt 6.7 |
Fonctions publiques
| weak_ordering(std::weak_ordering stdorder) | |
| operator Qt::partial_ordering() const | |
| operator std::weak_ordering() const |
Membres publics statiques
| const Qt::weak_ordering | equivalent |
| const Qt::weak_ordering | greater |
| const Qt::weak_ordering | less |
Éléments non membres associés
| bool | is_eq(Qt::weak_ordering o) |
| bool | is_gt(Qt::weak_ordering o) |
| bool | is_gteq(Qt::weak_ordering o) |
| bool | is_lt(Qt::weak_ordering o) |
| bool | is_lteq(Qt::weak_ordering o) |
| bool | is_neq(Qt::weak_ordering o) |
| bool | operator!=(Qt::weak_ordering lhs, Qt::weak_ordering rhs) |
| bool | operator==(Qt::weak_ordering lhs, Qt::weak_ordering rhs) |
Description détaillée
Une fonction de comparaison à trois voies renvoie généralement une valeur de type ` Qt::weak_ordering `. Une telle fonction compare deux objets et établit leur ordre. Elle utilise ce type de retour pour indiquer que l'ordre est faible ; c'est-à-dire que des valeurs équivalentes peuvent être distinguées.
Qt::weak_ordering Elle prend trois 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 l’opérande de gauche est équivalent à celui de droite ;
- greater indique que l’opérande de gauche est supérieur à celui de droite,
Qt::weak_ordering est couramment utilisé pour comparer 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:
Qt::weak_ordering compare(T lhs, T rhs); // defined out-of-line
~~~
Qt::weak_ordering result = compare(a, b);
if (result < 0) {
// a is less than b
}
if (compare(c, d) >= 0) {
// c is greater than or equivalent to d
}Voir également Qt::strong_ordering, Qt::partial_ordering et la présentation des types de comparaison.
Documentation des fonctions membres
[constexpr noexcept] weak_ordering::weak_ordering(std::weak_ordering stdorder)
Crée un objet ` Qt::weak_ordering ` à partir de ` stdorder ` en appliquant les règles suivantes :
- std::weak_ordering::less est converti en less.
- std::weak_ordering::equivalent est converti en equivalent.
- std::weak_ordering::greater est converti en greater.
[constexpr noexcept] weak_ordering::operator Qt::partial_ordering() const
Convertit cette valeur de type « Qt::weak_ordering » en un objet de type « Qt::partial_ordering » selon les règles suivantes :
- less se convertit en Qt::partial_ordering::less.
- equivalent convertit en Qt::partial_ordering::equivalent.
- greater convertit en Qt::partial_ordering::greater.
[constexpr noexcept] weak_ordering::operator std::weak_ordering() const
Convertit cette valeur de type ` Qt::weak_ordering ` en un objet de type `std::weak_ordering` selon les règles suivantes :
- less convertit en std::weak_ordering::less.
- equivalent convertit en std::weak_ordering::equivalent.
- greater convertit en std::weak_ordering::greater.
Documentation sur les variables membres
const Qt::weak_ordering weak_ordering::equivalent
Représente le résultat d'une comparaison dans laquelle l'opérande de gauche est équivalent à l'opérande de droite.
const Qt::weak_ordering weak_ordering::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 Qt::weak_ordering weak_ordering::less
Représente le résultat d'une comparaison dans laquelle l'opérande de gauche est inférieur à l'opérande de droite.
Éléments non membres associés
[constexpr noexcept] bool is_eq(Qt::weak_ordering o)
[constexpr noexcept] bool is_gt(Qt::weak_ordering o)
[constexpr noexcept] bool is_gteq(Qt::weak_ordering o)
[constexpr noexcept] bool is_lt(Qt::weak_ordering o)
[constexpr noexcept] bool is_lteq(Qt::weak_ordering o)
[constexpr noexcept] bool is_neq(Qt::weak_ordering o)
Convertit une expression « o » en 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::weak_ordering.
[constexpr noexcept] bool operator!=(Qt::weak_ordering lhs, Qt::weak_ordering rhs)
Renvoie « true » si lhs et rhs renvoient des résultats différents ; sinon, renvoie « true ».
[constexpr noexcept] bool operator==(Qt::weak_ordering lhs, Qt::weak_ordering 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.
