QThreadStorage Class

Ausführliche Beschreibung

QThreadStorage ist eine Template-Klasse, bei der der Template-Parameter T den Typ der pro Thread gespeicherten Daten angibt.

Die Funktion „ setLocalData()“ speichert einen einzelnen threadspezifischen Wert für den aufrufenden Thread. Auf die Daten kann später mit „ localData()“ zugegriffen werden.

Die Funktion ` hasLocalData()` ermöglicht es dem Programmierer festzustellen, ob Daten zuvor mit der Funktion ` setLocalData()` gesetzt wurden. Dies ist auch für die verzögerte Initialisierung nützlich.

Ist T ein Zeigertyp, übernimmt `QThreadStorage` die Verantwortung für die Daten (die mit ` new` auf dem Heap angelegt werden müssen) und löscht sie, wenn der Thread beendet wird – sei es normal oder durch Abbruch.

Der folgende Code verwendet beispielsweise `QThreadStorage`, um für jeden Thread, der die Funktionen `cacheObject()` und `removeFromCache()` aufruft, einen einzelnen Cache zu speichern. Der Cache wird automatisch gelöscht, wenn der aufrufende Thread beendet wird.

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

Einschränkungen

• Der Aufruf von ` hasLocalData()`, ` localData()` oder ` setLocalData()` während des Beendens eines Threads oder des Programms kann dazu führen, dass der thread-lokale Speicher für den aktuellen Thread neu erstellt wird, ohne dass anschließend noch etwas vorhanden ist, um ihn zu löschen.
• Der Destruktor von `QThreadStorage` löscht keine thread-spezifischen Daten. `QThreadStorage` löscht thread-spezifische Daten erst, wenn der Thread beendet wird oder wenn ` setLocalData()` mehrfach aufgerufen wird.
• QThreadStorage kann verwendet werden, um Daten für den Thread ` main() ` zu speichern. QThreadStorage löscht alle für den Thread ` main() ` festgelegten Daten, wenn ` QApplication ` zerstört wird, unabhängig davon, ob der Thread ` main() ` tatsächlich beendet wurde oder nicht.