En esta página

QThreadStorage Class

template <typename T> class QThreadStorage

La clase QThreadStorage permite almacenar datos por hilo. Más información...

Encabezado: #include <QThreadStorage>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son seguras para subprocesos.

Funciones públicas

QThreadStorage()
~QThreadStorage()
bool hasLocalData() const
T &localData()
T localData() const
void setLocalData(T data)

Descripción detallada

QThreadStorage es una clase de plantilla en la que el parámetro de plantilla T especifica el tipo de datos almacenados por hilo.

La función ` setLocalData()` almacena un único valor específico del hilo para el hilo que la invoca. Se puede acceder a los datos posteriormente mediante ` localData()`.

La función ` hasLocalData()` permite al programador determinar si los datos se han establecido previamente mediante la función ` setLocalData()`. Esto también resulta útil para la inicialización diferida.

Si T es un tipo de puntero, QThreadStorage asume la propiedad de los datos (que deben crearse en el montón mediante new) y los elimina cuando el hilo finaliza, ya sea de forma normal o mediante terminación.

Por ejemplo, el siguiente código utiliza `QThreadStorage` para almacenar una única caché para cada hilo que llame a las funciones `cacheObject()` y `removeFromCache()`. La caché se elimina automáticamente cuando el hilo que la ha llamado finaliza.

QThreadStorage<QCache<QString, SomeClass> > caches;

void cacheObject(const QString &key, SomeClass *object)
{
    caches.localData().insert(key, object);
}

void removeFromCache(const QString &key)
{
    if (!caches.hasLocalData())
        return;

    caches.localData().remove(key);
}

Advertencias

  • Llamar a hasLocalData(), localData() o setLocalData() durante el cierre del hilo o del programa puede volver a crear el almacenamiento local del hilo para el hilo actual sin que quede nada que lo destruya posteriormente.
  • El destructor de `QThreadStorage` no elimina los datos propios de cada hilo. `QThreadStorage` solo elimina los datos propios de cada hilo cuando este sale o cuando se llama a ` setLocalData()` varias veces.
  • QThreadStorage se puede utilizar para almacenar datos del hilo main(). QThreadStorage elimina todos los datos establecidos para el hilo main() cuando se destruye QApplication, independientemente de si el hilo main() ha finalizado realmente o no.

Véase también QThread.

Documentación de las funciones miembro

QThreadStorage::QThreadStorage()

Crea un nuevo objeto de almacenamiento de datos por hilo.

QThreadStorage::~QThreadStorage()

Elimina el objeto de almacenamiento de datos por hilo.

Nota: Los datos almacenados por hilo no se eliminan. Cualquier dato que quede en ` QThreadStorage ` se pierde. Asegúrate de que todos los hilos que utilizan ` QThreadStorage ` hayan finalizado antes de eliminar ` QThreadStorage`.

Véase también hasLocalData().

bool QThreadStorage::hasLocalData() const

Si T es un tipo de puntero, devuelve « true » si el hilo que realiza la llamada dispone de datos distintos de cero.

Si T es un tipo de valor, devuelve si los datos ya se han construido llamando a ` setLocalData ` o a ` localData`.

Véase también ` localData()`.

T &QThreadStorage::localData()

Devuelve una referencia a los datos establecidos por el hilo que realiza la llamada.

Si no se han establecido datos, se creará una instancia de tipo T con la construcción por defecto.

Véase también setLocalData() y hasLocalData().

T QThreadStorage::localData() const

Devuelve una copia de los datos que ha establecido el hilo que realiza la llamada.

Esta es una función sobrecargada.

Véase también ` hasLocalData()`.

void QThreadStorage::setLocalData(T data)

Establece los datos locales del hilo que realiza la llamada en ` data`. Se puede acceder a ellos posteriormente mediante las funciones ` localData()`.

Si T es un tipo de puntero, QThreadStorage asume la propiedad de los datos y los elimina automáticamente, ya sea cuando el hilo finaliza (ya sea de forma normal o mediante terminación) o cuando se vuelve a llamar a setLocalData().

Véanse también localData() y hasLocalData().

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