QThreadStorage Class

Description détaillée

QThreadStorage est une classe de modèle dont le paramètre de modèle T spécifie le type de données stockées par thread.

La fonction setLocalData() stocke une valeur unique spécifique au thread appelant. Ces données sont ensuite accessibles via la fonction localData().

La fonction hasLocalData() permet au programmeur de déterminer si des données ont déjà été définies à l’aide de la fonction setLocalData(). Cela est également utile pour l’initialisation paresseuse.

Si T est un type pointeur, `QThreadStorage` prend possession des données (qui doivent être créées sur le tas à l’aide de ` new`) et les supprime lorsque le thread se termine, que ce soit normalement ou par interruption.

Par exemple, le code suivant utilise QThreadStorage pour stocker un cache unique pour chaque thread appelant les fonctions `cacheObject()` et `removeFromCache()`. Le cache est automatiquement supprimé lorsque le thread appelant se termine.

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);
}

Mises en garde

• L'appel de ` hasLocalData()`, ` localData()` ou ` setLocalData()` lors de l'arrêt d'un thread ou du programme peut recréer le stockage local au thread pour le thread actuel, sans qu'il ne reste rien pour le détruire par la suite.
• Le destructeur de `QThreadStorage` ne supprime pas les données propres au thread. `QThreadStorage` ne supprime ces données que lorsque le thread se termine ou lorsque ` setLocalData()` est appelé plusieurs fois.
• QThreadStorage peut être utilisé pour stocker des données destinées au thread main(). QThreadStorage supprime toutes les données définies pour le thread main() lorsque QApplication est détruit, que le thread main() ait effectivement terminé ou non.