<QApplicationStatic>
| Header: | #include <QApplicationStatic> |
Macros
(since 6.3) | Q_APPLICATION_STATIC(Type, VariableName, ...) |
Documentación sobre macros
[since 6.3] Q_APPLICATION_STATIC(Type, VariableName, ...)
Esta macro amplía ` Q_GLOBAL_STATIC ` y crea un objeto global y estático de tipo ` QGlobalStatic`, con el nombre ` VariableName`, inicializado mediante los argumentos variádicos, y que se comporta como un puntero a ` Type`, donde la vida útil real del tipo está vinculada a ` QCoreApplication`. El objeto creado por Q_APPLICATION_STATIC se inicializa por sí mismo en su primer uso, lo que significa que no aumentará el tiempo de carga de la aplicación ni de la biblioteca. Además, el objeto se inicializa de forma segura para subprocesos en todas las plataformas.
A diferencia de Q_GLOBAL_STATIC, donde el tipo solo está pensado para ser destruido al salir del programa, aquí la vida útil real del tipo está vinculada a la vida útil de QCoreApplication. Esto lo hace ideal para almacenar QObjects semiestáticos, que también deben destruirse una vez que se destruya QCoreApplication. Esto significa que el tipo se eliminará una vez que el QCoreApplication emita la señal «destroyed». Se permite que el objeto se vuelva a crear cuando se acceda a él de nuevo, siempre que también se haya creado un nuevo QCoreApplication.
Dado que el valor está vinculado a QCoreApplication, solo se debe acceder a él si existe un QCoreApplication::instance() válido. Acceder a este objeto antes de que se cree QCoreApplication o después de que se haya destruido generará advertencias y puede provocar un comportamiento impredecible.
El uso típico de esta macro es el siguiente, en un contexto global (es decir, fuera del cuerpo de cualquier función):
Q_APPLICATION_STATIC(MyQObjectType, staticType, "some string", function())Ten en cuenta que los argumentos pasados de forma variádica a esta macro se evalúan cada vez que se construye el objeto, por lo que, en el ejemplo anterior, la función function se llamará más de una vez si se vuelve a crear el objeto.
Aparte de que el valor también está vinculado a la vida útil de ` QCoreApplication`, esta macro se comporta de forma idéntica a ` Q_GLOBAL_STATIC()`. Consulte la documentación de esa macro para obtener más información.
Garantías de multihilo
La macro `Q_APPLICATION_STATIC` garantiza que el objeto se inicialice solo una vez (por cada ciclo de vida de un ` QCoreApplication`), incluso si varios subprocesos intentan acceder al objeto de forma simultánea. Esto se consigue proporcionando un mutex por objeto; los desarrolladores de aplicaciones y bibliotecas deben tener en cuenta que su objeto se construirá con este mutex bloqueado y, por lo tanto, no deben volver a entrar en la inicialización del mismo objeto, ya que de lo contrario se producirá un interbloqueo.
No existe seguridad entre subprocesos en la destrucción del objeto: el código de usuario no debe acceder a este objeto una vez que el destructor de ` QCoreApplication ` comience a ejecutarse. El código de usuario debe tomar las medidas necesarias para garantizar que esto no ocurra, por ejemplo, evitando acceder a él una vez que el bucle de eventos del subproceso principal haya finalizado.
Al igual que Q_GLOBAL_STATIC, Q_APPLICATION_STATIC no ofrece garantías de seguridad entre subprocesos para los accesos al objeto una vez finalizada su creación. Corresponde al código del usuario garantizar que no se produzcan accesos a datos conflictivos.
En caso de que el objeto creado mediante esta operación sea un ` QObject`, su hilo asociado será aquel que haya logrado crearlo. Será destruido por el hilo principal, por lo que se recomienda llamar a ` moveToThread()` al hilo principal o a ningún hilo antes de su destrucción. Hacerlo desde el constructor de la clase en cuestión es una solución sensata si no se puede garantizar que sea el hilo principal el que inicialice el objeto.
Esta macro se introdujo en Qt 6.3.
Véase también Q_GLOBAL_STATIC y QGlobalStatic.
© 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.