QScopeGuard Class

template <typename F> class QScopeGuard

Fournit une protection de portée pour appeler une fonction à la fin d'une portée. Plus d'informations...

En-tête : #include <QScopeGuard>
CMake : find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake : QT += core

Fonctions publiques

QScopeGuard(F &&f)
QScopeGuard(const F &f)
void dismiss()
QScopeGuard<typename std::decay<F>::type> qScopeGuard(F &&f)

Description détaillée

QScopeGuard<F> est une classe dont le seul but est d'exécuter la fonction f dans son destructeur. Ceci est utile pour garantir l'exécution de votre code de nettoyage, que la fonction soit quittée normalement, qu'elle soit quittée prématurément par une instruction de retour ou qu'elle soit quittée par une exception.

Une garde de portée peut être désactivée en utilisant dismiss(), auquel cas la fonction n'est pas exécutée du tout.

Remarque : les exceptions ne sont pas prises en charge. L'appelable ne doit pas être lancé lorsqu'il est exécuté, copié ou déplacé.

Voir également QScopedValueRollback.

Documentation sur les fonctions membres

[explicit noexcept] QScopeGuard::QScopeGuard(F &&f)

[explicit noexcept] QScopeGuard::QScopeGuard(const F &f)

Crée une garde de portée qui exécutera f à la fin de la portée.

Si F est un lambda, son type ne peut pas être écrit. Dans ce cas, vous devez soit vous appuyer sur la déduction des arguments des modèles de classe (fonctionnalité du C++17) et laisser le paramètre de modèle complètement de côté, soit utiliser la fonction d'aide qScopeGuard() à la place de ce constructeur.

[noexcept] void QScopeGuard::dismiss()

Désarme la garde du champ d'application, de sorte que la fonction F ne sera pas appelée à la fin du champ d'application.

Non-membres apparentés

template <typename F> QScopeGuard<typename std::decay<F>::type> qScopeGuard(F &&f)

La fonction qScopeGuard peut être utilisée pour appeler une fonction à la fin du champ d'application.

Créez un garde de portée qui exécutera f à la fin de la portée.

Cette fonction d'aide est fournie pour que vous puissiez facilement construire un QScopeGuard sans avoir à nommer le paramètre de modèle pour le type de l'appelable. Si F est un lambda, vous ne pouvez pas écrire son type et il est nécessaire de s'appuyer sur cette fonction d'aide ou sur la déduction de l'argument du modèle de la classe.

Voici un exemple d'utilisation :

void myComplexCodeWithMultipleReturnPoints(int v)
{
    // The lambda will be executed right before your function returns
    auto cleanup = qScopeGuard([] { code you want executed goes HERE; });

    if (v == -1)
        return;

    int v2 = code_that_might_throw_exceptions();

    if (v2 == -1)
        return;

    (...)
}

© 2025 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.