Qt::weak_ordering Class
class Qt::weak_orderingQt::weak_ordering représente une comparaison où l'on peut encore distinguer des valeurs équivalentes. 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 |
Non-membres apparenté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 valeur de type Qt::weak_ordering est généralement renvoyée par une fonction de comparaison à trois voies. Une telle fonction compare deux objets et détermine 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 a trois valeurs, représentées par les constantes symboliques suivantes :
- less représente que l'opérande gauche est inférieur à l'opérande droit ;
- equivalent représente que l'opérande gauche est équivalent à l'opérande droit ;
- greater représente que l'opérande gauche est supérieur à l'opérande droit,
Qt::weak_ordering est utilisé 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: 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 Aperçu des types de comparaison.
Documentation sur les fonctions membres
[constexpr noexcept] weak_ordering::weak_ordering(std::weak_ordering stdorder)
Construit un objet Qt::weak_ordering à partir de stdorder en utilisant les règles suivantes :
- std::weak_ordering::less convertit en less.
- std::weak_ordering::equivalent convertit en equivalent.
- std::weak_ordering::greater convertit en greater.
[constexpr noexcept] weak_ordering::operator Qt::partial_ordering() const
Convertit cette valeur Qt::weak_ordering en un objet Qt::partial_ordering en utilisant les règles suivantes :
- less 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 Qt::weak_ordering en un objet std::weak_ordering en utilisant 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 des variables membres
const Qt::weak_ordering weak_ordering::equivalent
Représente le résultat d'une comparaison où l'opérande gauche est équivalent à l'opérande droit.
const Qt::weak_ordering weak_ordering::greater
Représente le résultat d'une comparaison où l'opérande de gauche est plus grand que l'opérande de droite.
const Qt::weak_ordering weak_ordering::less
Représente le résultat d'une comparaison où l'opérande de gauche est inférieur à l'opérande de droite.
Non-membres apparentés
[constexpr noexcept] bool is_eq(Qt::weak_ordering o)
[constexpr noexcept] bool is_neq(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_gt(Qt::weak_ordering o)
[constexpr noexcept] bool is_gteq(Qt::weak_ordering o)
Convertit o en résultat de l'un des six opérateurs relationnels :
| 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)
Retourne vrai si lhs et rhs représentent des résultats différents ; sinon, retourne vrai.
[constexpr noexcept] bool operator==(Qt::weak_ordering lhs, Qt::weak_ordering rhs)
Retourne vrai si lhs et rhs représentent le même résultat ; sinon, retourne faux.
© 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.
