QScopeGuard Class
template <typename F> class QScopeGuardOfrece una protección de ámbito para llamar a una función al final de un ámbito. Más información...
| Encabezado: | #include <QScopeGuard> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Funciones públicas
| QScopeGuard(F &&f) | |
| QScopeGuard(const F &f) | |
(since 6.11) void | commit() |
| void | dismiss() |
Elementos no miembros relacionados
| QScopeGuard<typename std::decay<F>::type> | qScopeGuard(F &&f) |
Descripción detallada
QScopeGuard<F> es una clase de plantilla en la que F es el tipo de un elemento invocable (como un puntero a función, un functor o una lambda) que se invocará en el destructor. Esto resulta útil para garantizar que se ejecute el código de limpieza, tanto si la función finaliza de forma normal como si se sale de ella anticipadamente mediante una instrucción «return» o por una excepción.
Un guard de ámbito se puede desactivar mediante ` dismiss()`, en cuyo caso la función no se ejecuta en absoluto, o bien se puede ejecutar antes de la destrucción mediante ` commit()`.
Nota: No se admitenexcepciones . El objeto ejecutable no debe lanzar excepciones al ejecutarse, copiarse o moverse.
Véase también QScopedValueRollback.
Documentación de la función miembro
[explicit noexcept] QScopeGuard::QScopeGuard(F &&f)
[explicit noexcept] QScopeGuard::QScopeGuard(const F &f)
Crea un guardián de ámbito que ejecutará « f » al final del ámbito.
Si F es una lambda, no es posible especificar su tipo. En ese caso, debes recurrir a la deducción de argumentos de plantillas de clase (característica de C++17) y omitir por completo el parámetro de plantilla, o bien utilizar la función auxiliar qScopeGuard() en lugar de este constructor.
[noexcept(...), since 6.11] void QScopeGuard::commit()
Llama a la función F y, a continuación, desactiva el guard de ámbito. El guard debe estar activado (no debe haberse llamado a ` dismiss()`) al llamar a esta función.
Esta función se introdujo en Qt 6.11.
Nota: Esta función es «noexcept» cuando std::is_nothrow_invocable_v<F> es « true ».
Véase también ` dismiss()`.
[noexcept] void QScopeGuard::dismiss()
Desactiva el protector de ámbito, de modo que la función F no se llame al final del ámbito.
Véase también commit().
Elementos no miembros relacionados
template <typename F> QScopeGuard<typename std::decay<F>::type> qScopeGuard(F &&f)
La función qScopeGuard se puede utilizar para llamar a una función al final del ámbito.
Crea un guard de ámbito que ejecute f al final del ámbito.
Esta función auxiliar se proporciona para que puedas construir fácilmente un ` QScopeGuard ` sin tener que nombrar el parámetro de plantilla para el tipo del objeto invocable. Si `F` es una lambda, no puedes escribir su tipo, por lo que es necesario recurrir a esta función auxiliar o a la deducción de argumentos de plantilla de clase.
A continuación se muestra un ejemplo de uso:
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;
//...
}© 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.