QThreadStorage 类

template <typename T> class QThreadStorage

QThreadStorage 类提供了每线程的数据存储。更多...

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

所有成员的列表，包括继承的成员
QThreadStorage 是线程类的一部分。

注意： 此类中所有函数都是线程安全的。

公共函数

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

详细描述

QThreadStorage 是一个模板类，它提供了每线程的数据存储。

setLocalData() 函数存储调用线程的一个特定值。可以通过 localData() 在以后访问数据。

hasLocalData() 函数允许程序员确定是否使用 setLocalData() 函数设置了数据。这也有助于惰性初始化。

如果 T 是指针类型，QThreadStorage 将拥有数据（必须在堆上使用 new 创建），并在线程退出时（无论是正常还是通过终止）删除它。

例如，以下代码使用 QThreadStorage 为调用 cacheObject() 和 removeFromCache() 函数的每个线程存储单个缓存。当调用方线程退出时，缓存将自动删除。

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

注意事项

QThreadStorage 析构函数不会删除每线程数据。只有当线程退出或当 setLocalData() 调用多次时，QThreadStorage 才会删除每线程数据。
QThreadStorage 可以用于存储 main() 线程的数据。当 QApplication 销毁时，无论 main() 线程是否已经完成，QThreadStorage 将删除为 main() 线程设置的全部数据。

另请参阅：QThread。